v171

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

List all prompts

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

get/v2/prompts

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

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

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

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

Prompts 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-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"
      }
    }
  ]
}