Skip to main content
GET
/
v2
/
prompts
/
{prompt_id}
/
versions
List prompt versions
curl --request GET \
  --url https://api.arize.com/v2/prompts/{prompt_id}/versions \
  --header 'Authorization: Bearer <token>'
{
  "prompt_versions": [
    {
      "id": "pv_002",
      "prompt_id": "prompt_001",
      "commit_hash": "def789ghi012",
      "commit_message": "Updated system prompt",
      "messages": [
        {
          "role": "system",
          "content": "You are a helpful assistant."
        }
      ],
      "input_variable_format": "f_string",
      "provider": "openAI",
      "model": "gpt-4",
      "created_at": "2024-01-02T12:00:00Z",
      "created_by_user_id": "user_12345"
    },
    {
      "id": "pv_001",
      "prompt_id": "prompt_001",
      "commit_hash": "abc123def456",
      "commit_message": "Initial version",
      "messages": [
        {
          "role": "system",
          "content": "You are an assistant."
        }
      ],
      "input_variable_format": "f_string",
      "provider": "openAI",
      "model": "gpt-4",
      "created_at": "2024-01-01T12:00:00Z",
      "created_by_user_id": "user_12345"
    }
  ],
  "pagination": {
    "next_cursor": "cursor_12345",
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

prompt_id
string
required

The unique identifier of the prompt A universally unique identifier

Example:

"RW50aXR5OjEyMzQ1"

Query Parameters

limit
integer
default:50

Maximum items to return

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Response

Returns a list of prompt version objects

prompt_versions
object[]
required

A list of prompt versions

pagination
object
required

Pagination metadata for cursor-based navigation