Skip to main content
GET
https://api.helicone.ai
/
v1
/
prompt-2025
/
{promptVersionId}
/
prompt-body
curl -X GET "https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body" \
  -H "Authorization: Bearer $HELICONE_API_KEY"

{
  "data": {
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful AI assistant.\n\nYou are speaking to {{ hc:name:string }}"
      }
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  },
  "error": null
}
Retrieves the complete prompt body content for a specific prompt version, including messages, model configuration, tools, and other parameters. The prompt body is stored in S3 and contains the actual template content.

​
Path Parameters

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

​
Response

​
model
string
The model specified in the prompt (e.g., “gpt-4o-mini”, “claude-3-opus”)
​
messages
array
Array of message objects that make up the prompt template
​
temperature
number
The temperature setting for the model (if configured)
​
max_tokens
number
The maximum number of tokens to generate (if configured)
​
tools
array
Array of tool/function definitions (if configured)
curl -X GET "https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body" \
  -H "Authorization: Bearer $HELICONE_API_KEY"

{
  "data": {
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful AI assistant.\n\nYou are speaking to {{ hc:name:string }}"
      }
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  },
  "error": null
}

​
Notes

  • This endpoint returns the full prompt body content, unlike other endpoints that only return metadata
  • The promptVersionId must be a UUID, not the 6-character prompt ID
  • Template variables in the format {{ hc:variableName:type }} can be used for dynamic content
  • Use the /v1/prompt-2025/query/versions endpoint to get the version UUID from a prompt ID