Skip to main content
POST
Approve or reject a held message

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
id
string
required

The object to change.

changes
object
required

The fields to change. POST /v1/help.describe gives the shape for each kind.

version
string

The version you read. Supplying it makes the update a compare-and-swap; a lost race is 409 precondition_failed and carries the object as stored.

idempotency_key
string

Response

The write was applied.

ref
string
created
boolean
version
string

The new version, to supply on the next update.

error
object