Prompts
Create a prompt version
Create a new version of an existing prompt.
Payload Requirements
- A commit_message is required.
- At least one message is required in messages.
- Do not include system-managed fields on input: id, commit_hash, created_at, created_by_user_id. Requests that contain these fields will be rejected.
- provider is required. input_variable_format defaults to F_STRING if not provided.
Valid example (create)
{
"commit_message": "Updated system prompt for better responses",
"input_variable_format": "F_STRING",
"provider": "OPEN_AI",
"model": "gpt-4",
"messages": [
{
"role": "SYSTEM",
"content": "You are a helpful assistant."
},
{
"role": "USER",
"content": "Hello, {name}!"
}
]
}
Invalid example (missing required commit_message)
{
"input_variable_format": "F_STRING",
"provider": "OPEN_AI",
"messages": [
{
"role": "USER",
"content": "Hello!"
}
]
}
<Note>This endpoint is in beta, read more here.</Note>
post/v2/prompts/{prompt_id}/versions
Path parameters
prompt_idstring required
A universally unique identifier (base64-encoded opaque string).
Example:RW50aXR5OjEyMzQ1
The unique prompt identifier (base64)
Request body
Response
A prompt version object