Skip to main content
POST
Create a prompt

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a prompt and its first version.

content
string
required

a string at least 1 character(s) long

Minimum string length: 1
id
string
required

a string matching the pattern ^[a-z0-9][a-z0-9/_-]*$

Required string length: 1 - 255
Pattern: ^[a-z0-9][a-z0-9/_-]*$
name
string
required

a string at most 255 character(s) long

Required string length: 1 - 255
config
object
description
string
message
string

a string at most 500 character(s) long

Maximum string length: 500

Response

A prompt, with its version history when includeVersions is set.

A prompt, with its version history when includeVersions is set.

channel
string | null
required

Addresses a version. latest is derived from the highest version rather than stored, so it cannot drift from the version table.

Required string length: 1 - 36
Pattern: ^[a-z0-9][a-z0-9_-]*$
config
object
required
content
string
required
createdAt
string
required

An ISO-8601 timestamp in UTC.

id
string
required

a string matching the pattern ^[a-z0-9][a-z0-9/_-]*$

Required string length: 1 - 255
Pattern: ^[a-z0-9][a-z0-9/_-]*$
message
string | null
required

a string at most 500 character(s) long

Maximum string length: 500
name
string
required

a string at most 255 character(s) long

Required string length: 1 - 255
version
integer
required

a positive number

versions
object[]