v66

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-04176310979.2 KB

prompts

Get Prompt History

Get a list of historical versions of a prompt by its ID

get/api/v1/prompts/{prompt_id}/history

Path parameters

prompt_idinteger required

Response

Successful Response

timestampstring date-time required

Timestamp of the change resulting in this version

prompt_idstring required

ID of the prompt

version_numberinteger required

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

prompt_textstring required

Text of the prompt at this version

prompt_descriptionstring nullable

Description of the prompt at this version

prompt_namestring required

Name of the prompt at this version

commentsstring nullable

Comments describing the change that resulted in this version

user_emailstring required

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

is_pre_enhancementsboolean required

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

Example response

[
  {
    "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": {
      "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": [
      {
        "tool_id": 1,
        "current_tool_name": "hangup"
      }
    ],
    "session_end_tool": {
      "tool_id": 1,
      "current_tool_name": "hangup"
    },
    "is_pre_enhancements": true
  }
]