Get Prompt Versions

Retrieve all versions of a specific prompt

1 min read

posthttps://api.helicone.ai/v1/prompt-2025/query/versions

curl -X POST "https://api.helicone.ai/v1/prompt-2025/query/versions" \  -H "Authorization: Bearer $HELICONE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "promptId": "prompt_123",    "majorVersion": 1  }'

[  {    "id": "version_456",    "model": "gpt-4",    "prompt_id": "prompt_123",    "major_version": 1,    "minor_version": 0,    "commit_message": "Initial version",    "created_at": "2024-01-14T10:30:00Z"  },  {    "id": "version_789",    "model": "gpt-4",    "prompt_id": "prompt_123",    "major_version": 1,    "minor_version": 1,    "commit_message": "Minor improvements to system prompt",    "created_at": "2024-01-15T14:20:00Z"  }]

posthttps://api.helicone.ai/v1/prompt-2025/query/versions

Retrieves all versions of a specific prompt, optionally filtered by major version.

Request Body#

promptIdstringrequired#

The unique identifier of the prompt

majorVersionnumber#

Filter versions by specific major version number

Response#

Returns an array of prompt version objects.

idstring#

Unique identifier of the prompt version

modelstring#

The model specified in the prompt

prompt_idstring#

The ID of the parent prompt

major_versionnumber#

The major version number

minor_versionnumber#

The minor version number

commit_messagestring#

The commit message for this version

created_atstring#

ISO timestamp when the version was created

s3_urlstring#

S3 URL where the prompt body is stored (if applicable)

Get Prompt Version by Environment Get Production Version