---
title: "Get Prompt History"
method: GET
path: "/api/v1/prompts/{prompt_id}/history"
tags: ["prompts"]
---

# Get Prompt History

`GET /api/v1/prompts/{prompt_id}/history`

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

## Path parameters

- `prompt_id` integer, required

## Response `200`

Successful Response

- PromptHistory[]
  - `timestamp` string, date-time, required — Timestamp of the change resulting in this version
  - `prompt_id` string, required — ID of the prompt
  - `version_number` integer, required — Version number of this version. Starts at 1 when prompt is created, and incremented on each change.
  - `prompt_text` string, required — Text of the prompt at this version
  - `prompt_description` string, nullable — Description of the prompt at this version
  - `prompt_name` string, required — Name of the prompt at this version
  - `llm_config` PromptLlmConfig — LLM configuration for a prompt.
    - `provider` 'anthropic' | 'azure_openai' | 'google' | 'openai' — LLM API provider.
    - `model` string — Name of the model. Must match the deployment name in Azure AI Studio.
    - `version` string, nullable — Deprecated model version. This value is ignored and resolved automatically.
    - `api_version` string, nullable — Version of the provider's API.
    - `temperature` number, nullable — Temperature parameter for the model. Determines randomness of responses - higher is more random, lower is more focused. Must be between 0.0 and 2.0, inclusive.
    - `seed` integer, nullable — Controls the reproducibility of the job. The LLM will give the same or similar responses given the same inputs in multiple conversations with the same seed.
  - `comments` string, nullable — Comments describing the change that resulted in this version
  - `user_email` string, required — Email address of the user who made the change that resulted in this version
  - `linked_tools` PromptHistoryLinkedTool[] — Tools that were linked to this version of the prompt
    - `tool_id` integer, required — ID of the tool
    - `current_tool_name` string, required — Current name of the tool (may have been different at the time the given version of the prompt was created)
    - `out_of_date` boolean, required — Whether the tool has changed (not including being deleted) since the given version of the prompt was created
    - `deleted` boolean, required — Whether the tool has been deleted since the given version of the prompt was created
  - `session_end_tool` PromptHistoryLinkedTool — Record of a tool linked to a previous prompt version in the prompt history.
    - `tool_id` integer, required — ID of the tool
    - `current_tool_name` string, required — Current name of the tool (may have been different at the time the given version of the prompt was created)
    - `out_of_date` boolean, required — Whether the tool has changed (not including being deleted) since the given version of the prompt was created
    - `deleted` boolean, required — Whether the tool has been deleted since the given version of the prompt was created
  - `is_pre_enhancements` boolean, required — Whether this version of the prompt was created before history of tool-prompt linking was tracked

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/versions/ac3228f980bb/schema)