Retrieve a prompt version

curl https://api.respan.ai/api/prompts/prompt_id/versions/3/ \
     -H "Authorization: Bearer <respanApiKey>"

{
  "id": "pv_abc123",
  "prompt_version_id": "pv_abc123",
  "version": 3,
  "description": "Added context variable",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant. Context: {{context}}"
    },
    {
      "role": "user",
      "content": "{{user_query}}"
    }
  ],
  "thinking": null,
  "model": "gpt-4o",
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 2048,
  "top_p": 1,
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "reasoning_effort": null,
  "verbosity": null,
  "seed": null,
  "variables": {
    "context": "",
    "user_query": ""
  },
  "fallback_models": [
    "gpt-4o-mini"
  ],
  "load_balance_models": [
    {
      "model": "gpt-4o",
      "weight": 0.8
    },
    {
      "model": "gpt-4o-mini",
      "weight": 0.2
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_knowledge_base"
      }
    }
  ],
  "tool_choice": "auto",
  "response_format": null,
  "json_schema": null,
  "is_enforcing_response_format": false,
  "readonly": false,
  "is_deployed": false,
  "edited_by": {
    "id": 123,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "created_at": "2026-01-20T10:30:00Z",
  "updated_at": "2026-01-20T10:30:00Z"
}

Retrieve a specific version of a prompt.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

prompt_idstringRequired

The unique prompt identifier.

versionintegerRequired

The prompt version number.

Response

Prompt version details.

idstring

prompt_version_idstring

versioninteger

descriptionstring or null

messageslist of maps from strings to any

thinkingobject or null

modelstring

streamboolean

temperaturedouble or null

max_tokensinteger or null

top_pdouble or null

frequency_penaltydouble or null

presence_penaltydouble or null

reasoning_effortstring or null

verbositystring or null

seedinteger or null

variablesobject

fallback_modelslist of strings or null

load_balance_modelslist of objects or null

toolslist of objects or null

tool_choicestring or map from strings to any or null

response_formatobject or null

json_schemaobject or null

is_enforcing_response_formatboolean

readonlyboolean

is_deployedboolean

edited_byobject

created_atdatetime

updated_atdatetime

Errors

401

Unauthorized Error

404

Not Found Error