POST
/
v1
/
prompt-2025
curl -X POST "https://api.helicone.ai/v1/prompt-2025" \
  -H "Authorization: Bearer $HELICONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "tags": ["support", "chatbot"],
    "promptBody": {
      "model": "gpt-4",
      "messages": [
        {
          "role": "system",
          "content": "You are a helpful customer support assistant."
        }
      ],
      "temperature": 0.7
    }
  }'

{
  "id": "prompt_123",
  "versionId": "version_456"
}
Creates a new prompt with the specified name, tags, and initial prompt body. Returns the prompt ID and initial version ID.

​
Request Body

​
name
string
required
Name of the prompt
​
tags
string[]
required
Array of tags to associate with the prompt
​
promptBody
OpenAIChatRequest
required
The initial prompt body following OpenAI chat completion format

​
Response

​
id
string
Unique identifier of the created prompt
​
versionId
string
Unique identifier of the initial prompt version
curl -X POST "https://api.helicone.ai/v1/prompt-2025" \
  -H "Authorization: Bearer $HELICONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "tags": ["support", "chatbot"],
    "promptBody": {
      "model": "gpt-4",
      "messages": [
        {
          "role": "system",
          "content": "You are a helpful customer support assistant."
        }
      ],
      "temperature": 0.7
    }
  }'

{
  "id": "prompt_123",
  "versionId": "version_456"
}