curl -X GET "https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body" \
-H "Authorization: Bearer $HELICONE_API_KEY"
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body', {
method: 'GET',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
},
});
const promptBody = await response.json();
import requests
response = requests.get(
'https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body',
headers={
'Authorization': f'Bearer {HELICONE_API_KEY}',
}
)
prompt_body = response.json()
{
"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
}
Prompts
Get Prompt Body
Retrieve the full prompt body (messages, tools, etc.) for a specific prompt version
GET
/
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"
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body', {
method: 'GET',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
},
});
const promptBody = await response.json();
import requests
response = requests.get(
'https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body',
headers={
'Authorization': f'Bearer {HELICONE_API_KEY}',
}
)
prompt_body = response.json()
{
"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
string
required
The unique identifier (UUID) of the prompt version to retrieve
Response
string
The model specified in the prompt (e.g., “gpt-4o-mini”, “claude-3-opus”)
array
number
The temperature setting for the model (if configured)
number
The maximum number of tokens to generate (if configured)
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"
const response = await fetch('https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body', {
method: 'GET',
headers: {
'Authorization': `Bearer ${HELICONE_API_KEY}`,
},
});
const promptBody = await response.json();
import requests
response = requests.get(
'https://api.helicone.ai/v1/prompt-2025/6739b412-5fbb-498e-ab99-68ef21eb7df8/prompt-body',
headers={
'Authorization': f'Bearer {HELICONE_API_KEY}',
}
)
prompt_body = response.json()
{
"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
promptVersionIdmust 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/versionsendpoint to get the version UUID from a prompt ID
Was this page helpful?