Submit intent
Appends a create, replace, or cancel trading intent for the trading account named in the request body. Submission is authorized for API-key callers that belong to the account organization and have organization intent edit permission. Create intents on live accounts additionally require the Trading Live entitlement and must pass controls evaluation before an action and outbox record are written.
Authorizations
Body
Intent command to append, together with the trading_account_id that should execute it. Create starts a new intent lineage; replace and cancel append to the lineage referenced by the command payload's ref_intent_id. The top-level client_reference_id is accepted for caller correlation but is not currently persisted on newly created action records.
Requested intent operation and its payload.
- Option 1
- Option 2
- Option 3
Trading account that should execute the intent.
Carried in the body rather than the path: submission is a command against the caller's organization, and the account it targets is part of the command.
Optional caller-provided correlation ID for downstream reconciliation.
Response
Intent accepted