Prompts

List prompt versions

Changed on Oct 21, 2026

Results are ordered newest first.

get/api/prompts/{prompt_id}/versions/

Request

Base URL
https://api.respan.ai
URL
https://api.respan.ai/api/prompts/{prompt_id}/versions/
Auth
- HTTP bearer
- or HTTP bearer

Path parameters

prompt_idstring required

The unique prompt identifier.

Query parameters

pageinteger

Page number.

page_sizeinteger

Number of prompt versions per page. Maximum is 500.

Response

Paginated list of prompt versions.

countinteger

Number of results on this page, not the total. Request pages until next is null to get every result.

nextstring nullable

Next page URL.

previousstring nullable

Previous page URL.

Example response

{
  "count": 5,
  "next": null,
  "previous": null,
  "results": [
    {
      "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"
    }
  ]
}

Changes

Oct 21, 2026c30bcb383ee8 Revision changes
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  added subschema #1 subschema #2 to the // response property oneOf list for the response status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the // response's property type changed from number null to number, and format from double to no format for status
- info
  api operation id prompts_listPromptVersions removed and replaced with listPromptVersions
- info
  the endpoint scheme security DashboardJwt was added to the API
- info
  api tag Prompts added
- info
  api tag prompts removed
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #1 subschema #2 from the // response property oneOf list for the response status
Oct 2, 2026b830b79cfd52 Revision changes
- warning
  removed the optional property from the response with the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the required property to the response with the status

Operation history (4 revisions)