API reference

API reference · Prompts

Point a label at a version, or take it off

PUT/api/account/prompts/{id}/labelsSigned in session

production is the label a request that names no version or label gets, when it is set; else the newest version. At most 10 labels a prompt. Same origin.

Parameters

Path and query parameters
FieldTypeWhat it is
id (path)requiredstringpmpt_ id.

Request body

application/json, required

Request body fields
FieldTypeWhat it is
labelrequiredstring
versionrequiredinteger or nullnull takes the label off.

Example

{
  "label": "string",
  "version": 0
}

Answer 200

The prompt.

Fields of the 200 answer
FieldTypeWhat it is
promptobject
prompt.idstring
prompt.namestring
prompt.descriptionstring or null
prompt.latestVersioninteger
prompt.labelsobjectLabel to version.
prompt.createdAtinteger
prompt.updatedAtinteger
versionsarray of object
versions[].versioninteger
versions[].messagesarray of object
versions[].messages[].rolerequiredstringOne of "system", "developer", "user", "assistant".
versions[].messages[].contentrequiredstringText with {{variables}}: two braces, a name, two braces. At most 64000 characters.
versions[].variablesarray of string
versions[].modelstring or null
versions[].notestring or null
versions[].createdAtintegerEpoch ms.

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 404OpenAI 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.

Antimatter