Skip to main content
POST
Generate skill drafts

Authorizations

Authorization
string
header
required

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

Body

application/json
prompt
string

Natural-language description of the skill(s) to generate. At least one of prompt or file_ids must be non-empty.

Maximum string length: 16000
file_ids
string[]

IDs of previously uploaded files to use as source material (e.g. SOP documents). Obtain file IDs via POST /v1/files. At least one of prompt or file_ids must be non-empty.

Maximum array length: 16

Response

Generated skill drafts.

object
enum<string>
required

The object type, always 'list'.

Available options:
list
data
object[]
required

Array of generated skill drafts. Pass each to POST /v1/skills to persist.

has_more
boolean
required

Whether there are more results. Always false for generate.