Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The prompt’s name, meant to be displayable in the UI.
128Entity storage path in the format: project/folder/subfolder/...
The first element identifies the project, followed by nested folders (auto-created as needed).
With project-based API keys, the first element is treated as a folder name, as the project is predetermined by the API key.
"Default"
The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose
[DEPRECATED]. Please use the prompt property instead. The current prompt_config will keep working but it will be deprecated in future versions. Configuration for the prompt including model and messages.
Prompt configuration with model and messages. Either this field or prompt_config must be provided.
{
  "model": "openai/gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant"
    },
    {
      "role": "user",
      "content": "What is the weather today?"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000
}Response
Prompt created.
A prompt entity with configuration, metadata, and versioning.
prompt The prompt’s name, meant to be displayable in the UI.
128A list of messages compatible with the openAI schema
The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose