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
Response
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?