Get Prompt Version

Retrieve a specific prompt version with its content

1 min read

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

curl -X POST "https://api.helicone.ai/v1/prompt-2025/query/version" \  -H "Authorization: Bearer $HELICONE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "promptVersionId": "version_456"  }'

{  "id": "version_456",  "model": "gpt-4",  "prompt_id": "prompt_123",  "major_version": 1,  "minor_version": 2,  "commit_message": "Updated system prompt for better responses",  "environment": "production",  "created_at": "2024-01-15T10:30:00Z",  "s3_url": "https://s3.amazonaws.com/bucket/prompt-body.json"}

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

Retrieves detailed information about a specific prompt version, including the full prompt body content.

Request Body#

promptVersionIdstringrequired#

The unique identifier of the prompt version to retrieve

Response#

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

environmentstring#

The environment this version is assigned to (e.g., "production", "staging")

created_atstring#

ISO timestamp when the version was created

s3_urlstring#

S3 URL where the prompt body is stored

Query Prompts Get Prompt Version by Environment