Submit a tool call with an explicit spending maximum and a stable idempotency key.

post/v1/invoke

Request

  • Base URL
    http://localhost:5100
  • URL
    http://localhost:5100/v1/invoke
  • Auth
    HTTP bearer

Request body

toolIdstring required
idempotencyKeystring required
connectionIdstring uuid
quoteContextstring
credentialMode'platform' | 'customer'

Use the o11 account by default. Select customer only for an explicitly chosen connected provider account.

maxCostMicrosstring required
allowWriteboolean
acceptRecurringboolean
searchIdstring uuid
runIdstring uuid

Reuse one run UUID across this task's calls. This label groups receipts; it does not authorize spending or create a budget.

cardIdstring uuid

Card to use. Required when this connection has multiple cards. List cards first.

Response

Operation result. An invocation may still be pending; inspect its state.

completedAtstring date-time nullable
nextAction'poll' | 'inspect_result' | 'request_approval' | 'request_manager_review' | 'none'
idstring uuid required
runIdstring uuid
toolIdstring required
toolNamestring required
state'awaiting_approval' | 'queued' | 'executing' | 'waiting' | 'succeeded' | 'failed' | 'unknown' | 'cancelled' required
canResumeboolean required
reservedMicrosstring required
billedMicrosstring nullable required
settlementBasis'catalog' | 'provider' | 'operator' | 'none' nullable required
supplierCostMicrosstring nullable
providerJobIdstring nullable required
resultunknown required
errorstring nullable required
createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.