Skip to main content
POST
Create a draft

Authorizations

Authorization
string
header
required

Bearer token for one agent. Pass as Authorization: Bearer <token>.

A token is shown once when it is issued and is not recoverable afterwards. Treat it as a secret: it reaches one agent's mail, calendar and contacts, and anything a grant has extended to it.

Body

application/json
body
object
required

The object itself. Its shape depends on what is being created; POST /v1/help.describe gives the shape for each.

in
string

What to create it within, where the kind needs one.

idempotency_key
string

Makes a repeat return the first attempt's result rather than creating a second object.

Response

The write was applied.

ref
string
created
boolean
version
string

The new version, to supply on the next update.

error
object