Reserve an operation

Validates and reserves a channel-neutral operation against the current quote and budget gate, returning an execution envelope (status: quoted | blocked). The operation itself is not run and no usage is settled by this call.

post/v1/operations/execute

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/operations/execute
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

operationIdstring required
surface'api' | 'mcp' | 'cli' | 'excel' | 'sheets' | 'sdk_js' | 'sdk_py' | 'sdk_go' | 'sdk_rust' required
operationSchemaVersionstring nullable
quoteIdstring nullable
idempotencyKeystring required
clientIdstring nullable
workbookInstallationIdstring nullable
sourceKeystring nullable
artifactClassstring nullable
evidenceRequirementstring nullable
planKeystring nullable
meterClassstring nullable
pathstring nullable
methodstring nullable
unitsnumber nullable
metadataobject nullable

Response

Successful response

object'operation_execution' required
executionIdstring required
status'quoted' | 'blocked' required
settlementMode'shadow' required
budgetGateobject nullable required
requestIdstring required

Changes

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