Sign in

v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB
Prompts

Retrieve a prompt version

Retrieves a specific version of a prompt by its ID and version ID.

get/v2/prompts/{prompt_id}/versions/{version_id}

Path parameters

prompt_idstring required

The unique identifier of the prompt

The unique identifier of the prompt

version_idstring required

The unique identifier of the prompt version

The unique identifier of the prompt version

Response

Prompt version retrieved successfully.

_idstring required
created_by_idstring uuid nullable
updated_by_idstring uuid nullable
descriptionstring nullable

The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose

timestampstring required

Example response

{
  "prompt_config": {
    "messages": [
      {
        "content": [
          {
            "image_url": {
              "url": "https://picsum.photos/id/1/200/300"
            }
          }
        ]
      }
    ]
  },
  "prompt": {
    "fallbacks": [
      {
        "model": "openai/gpt-4o-mini"
      }
    ],
    "retry": {
      "count": 3,
      "on_codes": [
        429,
        500,
        502,
        503,
        504
      ]
    },
    "cache": {
      "ttl": 3600
    },
    "load_balancer": {
      "type": "weight_based",
      "models": [
        {
          "model": "openai/gpt-4o",
          "weight": 0.7
        },
        {
          "model": "anthropic/claude-3-5-sonnet",
          "weight": 0.3
        }
      ]
    },
    "timeout": {
      "call_timeout": 30000
    },
    "model": "openai/gpt-4o"
  }
}