API reference · Prompts
Keep a prompt, with its first version
POST/api/account/promptsSigned in session
At most 200 prompts an account. Same origin.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| namerequired | string | At most 120 characters. |
| description | string or null | At most 1000 characters. |
| messagesrequired | array of object | |
| messages[] | string | One of "system", "developer", "user", "assistant". |
| messages[] | string | Text with {{variables}}: two braces, a name, two braces. At most 64000 characters. |
| model | string or null | Sent when a request that names this version names no model. |
| note | string or null | At most 500 characters. |
Example
{
"name": "string",
"messages": [
{
"role": "user",
"content": "Say hello in five words."
}
],
"model": "antimatter/auto"
}Answer 201
The prompt.
| Field | Type | What it is |
|---|---|---|
| prompt | object | |
| prompt. | string | |
| prompt. | string | |
| prompt. | string or null | |
| prompt. | integer | |
| prompt. | object | Label to version. |
| prompt. | integer | |
| prompt. | integer | |
| versions | array of object | |
| versions[] | integer | |
| versions[] | array of object | |
| versions[] | string | One of "system", "developer", "user", "assistant". |
| versions[] | string | Text with {{variables}}: two braces, a name, two braces. At most 64000 characters. |
| versions[] | array of string | |
| versions[] | string or null | |
| versions[] | string or null | |
| versions[] | integer | Epoch ms. |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 409OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.