ORorq-ai
Prompts

Retrieve a prompt version

Changed on

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

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

Request

  • Base URL
    https://my.orq.ai
  • URL
    https://my.orq.ai/v2/prompts/{prompt_id}/versions/{version_id}
  • Auth
    HTTP bearer

Path parameters

prompt_idstring required

The unique identifier of the prompt

version_idstring required

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-5.4-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-5.6-sol"
  }
}

Changes

  • 928a71e92252Revision changes
    • breaking

      added to the // response property oneOf list for the response status

    • warning

      added the new munito enum value to the // response property for the response status

    • warning

      added the new particle enum value to the // response property for the response status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added between_tools discriminator mapping keys to the // response property for the response status

  • 33d63277cd4eRevision changes
    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • info

      removed between_tools discriminator mapping keys from the // response property for the response status

    • info

      removed the munito enum value from the // response property for the response status

    • info

      removed the particle enum value from the // response property for the response status

    • info

      removed from the // response property oneOf list for the response status