Decide todo

Decide todo in the credential-bound company. Call todo.decide.preview first and include its confirmation token when committing this action. The required Idempotency-Key coordinates this operation but does not provide durable response replay. This action posts accounting effects. Requires the todos:action OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Confirmed values used to decide todo, including the confirmation token returned by todo.decide.preview.

The answer previewed with exactly these fields (Brain foundation C7a),
with the preview's confirmation token, sent with the same Idempotency-Key,
and the status the to-do had when it was read.

string
required
length ≤ 48

The answer's key, as the to-do lists it (todo.show outcomes[].outcome), e.g. later, not_for_me, book_category.

params
object | null

The answer's parameters, an object of names and values (todo.show outcomes[].params names them). Never note, subject, message, body or remember inside params: over REST they are fields of their own (body is message), and they are not available through MCP.

string | null

The person's note for the to-do's history. Not available through MCP.

string | null

The subject of the email the answer sends (send_request, send_reminder, send_draft). Not available through MCP.

string | null

The words of the email the answer sends. Not available through MCP.

boolean

Remember this: book the supplier this way from now on (book_category). Not available through MCP.

string
enum
required

The to-do's status when it was read (todo.decide.preview status); a to-do no longer in it is refused (409 todo_changed_since).

Allowed:
string
required
length ≤ 8192

The token from todo.decide.preview, sent with the same Idempotency-Key.

boolean

The person held the answer to confirm it, when its preview says needs_hold. Through MCP only with the approval_id of an approval a person granted for todo.decide on this to-do: holding to confirm is the person's own act.

Headers
string
required
length ≤ 191

Required operation-specific request key. This requirement does not imply durable public API response replay.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*