Skip to main content
POST
/
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"
}
Retrieves detailed information about a specific prompt version, including the full prompt body content.

​
Request Body

​
promptVersionId
string
required
The unique identifier of the prompt version to retrieve

​
Response

​
id
string
Unique identifier of the prompt version
​
model
string
The model specified in the prompt
​
prompt_id
string
The ID of the parent prompt
​
major_version
number
The major version number
​
minor_version
number
The minor version number
​
commit_message
string
The commit message for this version
​
environment
string
The environment this version is assigned to (e.g., “production”, “staging”)
​
created_at
string
ISO timestamp when the version was created
​
s3_url
string
S3 URL where the prompt body is stored
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"
}