ORorq-ai
Prompts

List all prompt versions

Changed on

Returns a list of your prompt versions. The prompt versions are returned sorted by creation date, with the most recent prompt versions appearing first

get/v2/prompts/{prompt_id}/versions

Request

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

Path parameters

prompt_idstring required

Query parameters

limitinteger

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

starting_afterstring

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 starting_after=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the next page of the list.

ending_beforestring

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 ending_before=01JJ1HDHN79XAS7A01WB3HYSDB in order to fetch the previous page of the list.

Response

Prompt versions retrieved.

object'list' required
has_moreboolean required

Example response

{
  "data": [
    {
      "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