GET
/
api
/
v1
/
prompts
/
{prompt_id}
/
history
Python (SDK)
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.prompts.prompts_history(prompt_id=922849)

    # Handle response
    print(res)
[
  {
    "timestamp": "2024-01-01T12:00:00Z",
    "prompt_id": "1",
    "version_number": 1,
    "prompt_text": "You are a weather agent. Answer the user's questions about weather and nothing else.",
    "prompt_description": "Prompt for a weather agent.",
    "prompt_name": "Weather Agent Prompt",
    "llm_config": {
      "provider": "azure_openai",
      "model": "gpt-4o",
      "version": "2024-05-13",
      "api_version": "2024-06-01",
      "temperature": 1,
      "seed": 123
    },
    "comments": "Updated prompt text to include requirement to not answer questions that aren't about weather.",
    "user_email": "user@email.com",
    "linked_tools": [],
    "is_pre_enhancements": true
  }
]

Authorizations

​
Syllable-API-Key
string
header
required

Path Parameters

​
prompt_id
integer
required

Response

Successful Response

​
timestamp
string<date-time>
required

Timestamp of the change resulting in this version

Examples:

"2024-01-01T12:00:00Z"

​
prompt_id
string
required

ID of the prompt

Examples:

"1"

​
version_number
integer
required

Version number of this version. Starts at 1 when prompt is created, and incremented on each change.

Examples:

1

​
prompt_text
string
required

Text of the prompt at this version

Examples:

"You are a weather agent. Answer the user's questions about weather and nothing else."

​
prompt_name
string
required

Name of the prompt at this version

Examples:

"Weather Agent Prompt"

​
user_email
string
required

Email address of the user who made the change that resulted in this version

Examples:

"user@email.com"

​
is_pre_enhancements
boolean
required

Whether this version of the prompt was created before history of tool-prompt linking was tracked

Examples:

true

​
prompt_description
string | null

Description of the prompt at this version

Examples:

"Prompt for a weather agent."

​
llm_config
object | null

String representation of LLM config for the prompt at this version LLM configuration for a prompt.

​
comments
string | null

Comments describing the change that resulted in this version

Examples:

"Updated prompt text to include requirement to not answer questions that aren't about weather."

​
linked_tools
PromptHistoryLinkedTool · object[]

Tools that were linked to this version of the prompt