Skip to main content
POST
Act for the user

Authorizations

Authorization
string
header
required

The permit the user approved for your app.

Headers

idempotency-key
string<uuid>

A UUID your app generates for this act. Send the same value when you retry, and Circuit acts once and returns the first result. Reusing a key with different contents returns 409. Without a key, a retried act can happen twice.

Body

application/json

One thing to do for the user. Starts, top-ups, stops and approvals take effect immediately, so send them only after the user confirms in your app.

say
object
required

Response

OK

What an act created or changed: a message to Ask, or a proposal.

kind
string
required
Allowed value: "message"