Skip to main content
GET
/
v2
/
prompts
/
{prompt_id}
/
versions
List all prompt versions
curl --request GET \
  --url https://api.orq.ai/v2/prompts/{prompt_id}/versions \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "_id": "<string>",
      "prompt": {
        "name": "<string>",
        "audio": {
          "voice": "alloy",
          "format": "wav"
        },
        "frequency_penalty": 123,
        "max_tokens": 123,
        "max_completion_tokens": 123,
        "logprobs": true,
        "top_logprobs": 10,
        "n": 2,
        "presence_penalty": 123,
        "response_format": {
          "type": "text"
        },
        "reasoning_effort": "none",
        "verbosity": "<string>",
        "seed": 123,
        "stop": "<string>",
        "stream_options": {
          "include_usage": true
        },
        "thinking": {
          "type": "disabled"
        },
        "temperature": 1,
        "top_p": 0.5,
        "top_k": 123,
        "tool_choice": "none",
        "parallel_tool_calls": true,
        "modalities": [
          "text"
        ],
        "guardrails": [
          {
            "id": "orq_pii_detection",
            "execute_on": "input"
          }
        ],
        "fallbacks": [
          {
            "model": "openai/gpt-4o-mini"
          }
        ],
        "retry": {
          "count": 3,
          "on_codes": [
            429,
            500,
            502,
            503,
            504
          ]
        },
        "cache": {
          "type": "exact_match",
          "ttl": 3600
        },
        "load_balancer": {
          "type": "weight_based",
          "models": {
            "type": "weight_based",
            "models": [
              {
                "model": "openai/gpt-4o",
                "weight": 0.7
              },
              {
                "model": "anthropic/claude-3-5-sonnet",
                "weight": 0.3
              }
            ]
          }
        },
        "timeout": {
          "call_timeout": 30000
        },
        "messages": [
          {
            "role": "system",
            "content": "<string>",
            "name": "<string>"
          }
        ],
        "model": "openai/gpt-4o",
        "version": "<string>"
      },
      "timestamp": "<string>",
      "created_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updated_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "description": "<string>",
      "prompt_config": {
        "messages": [
          {
            "role": "system",
            "content": "<string>",
            "tool_calls": [
              {
                "type": "function",
                "function": {
                  "name": "<string>",
                  "arguments": "<string>"
                },
                "id": "<string>",
                "index": 123
              }
            ],
            "tool_call_id": "<string>"
          }
        ],
        "stream": true,
        "model": "<string>",
        "model_db_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "model_type": "chat",
        "model_parameters": {
          "temperature": 123,
          "maxTokens": 123,
          "topK": 123,
          "topP": 123,
          "frequencyPenalty": 123,
          "presencePenalty": 123,
          "numImages": 123,
          "seed": 123,
          "format": "url",
          "dimensions": "<string>",
          "quality": "<string>",
          "style": "<string>",
          "responseFormat": {
            "type": "json_schema",
            "json_schema": {
              "name": "<string>",
              "schema": {},
              "description": "<string>",
              "strict": true
            },
            "display_name": "<string>"
          },
          "photoRealVersion": "v1",
          "encoding_format": "float",
          "reasoningEffort": "none",
          "budgetTokens": 123,
          "verbosity": "low",
          "thinkingLevel": "low"
        },
        "provider": "openai",
        "integration_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "version": "<string>"
      },
      "metadata": {
        "language": "English"
      }
    }
  ],
  "has_more": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

prompt_id
string
required

Query Parameters

limit
integer
default:10

A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10

Required range: 1 <= x <= 200
starting_after
string

A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include after=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the next page of the list.

ending_before
string

A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with 01JJ1HDHN79XAS7A01WB3HYSDB, your subsequent call can include before=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the previous page of the list.

Response

200 - application/json

Prompt versions retrieved.

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
boolean
required