Intents
Cancel an intent
Cancel an intent before execution starts.
POST
/v1/agent-api/intents/{intentId}/cancelPath parameters
intentIdstringRequiredResponses
200Full intent state after cancellation. Repeating the request for an already-cancelled intent returns the same successful projection. Cancellation is only available before execution starts and cannot stop or reverse work already executing.
404Intent missing or not owned by the authenticated agent (
intent_not_found)409Intent is not eligible for cancellation (
intent_not_cancellable)Response fields
idstringRequiredaccountIdstringOptionalResolved source account, pinned when the intent was created. Omitted for actions without an account.
type"send" | "transfer" | "create_counterparty" | "request_counterparty_details" | "x402" | "mpp" | "policy_override"Requiredstatus"pending" | "processing" | "completed" | "blocked" | "failed"Requiredresolution"completed" | "blocked" | "denied" | "expired" | "failed" | "cancelled" or string or nullRequiredExact terminal outcome, or null while the intent is nonterminal. Known values are completed, blocked, denied, expired, failed, and cancelled; clients must preserve future nonblank strings.
reasonsarray of stringRequiredexpiresAtstring or nullRequiredmovementobjectOptionalmovement.planIdstringRequiredmovement.nextStep"wait" | "done" | "blocked"Requireddataobject or nullRequiredmetadataobjectRequiredmetadata.dataUrlstring or nullRequired