Skip to main content
Commit a proposal
Beta. The assistant API and its reads over MCP are in beta. They are open to every organization that pays out through Grade, and parts are not available yet, as each page says.
Sending the same token again never writes twice: a finished commit answers its first receipt. After 504 COMMIT_OUTCOME_UNKNOWN the first route may have written: check the outcome in Grade, and never ask the assistant for a new proposal to recover it, since a new proposal is a new write. A proposal can be committed for 24 hours after the assistant made it.

Authorizations

X-Application-Id
string
header
required
X-Api-Key
string
header
required

Body

application/json

The proposal to commit.

proposal_token
string
required

The action event's proposal_token.

Maximum string length: 65536

Response

The receipt: one row per creator or post.

proposal_id
string
required
action
string
required
status
enum<string>
required
Available options:
saved,
partial,
refused
http_status
integer
required

The status the rows share, or 207 when they differ.

rows
object[]
required