Skip to main content
POST
Save a prompt

Authorizations

X-API-Key
string
header
required

Body

application/json

Save one prompt for this workspace to use again.

body
string
required

The message the card will put in the composer.

Required string length: 1 - 2000
title
string | null

What to call the card. Left out, a name is taken from the prompt's own first sentence, which is what saving a message you already sent does.

Required string length: 1 - 60

Response

Successful Response

One prompt offered under the assistant's composer.

body
string
required

The message pressing the card puts in the composer.

built_in
boolean
required

Whether we wrote it. A built-in cannot be edited or deleted.

key
string
required

Stable identifier for this card across both kinds: the built-in's key, or the saved prompt's id.

title
string
required

What the card is called.

created_at
string<date-time> | null
id
string<uuid> | null

Null for a built-in prompt, which is defined in our code rather than saved.

updated_at
string<date-time> | null