Execution Intents

Execute an intent

post/v1/agents/{agent_id}/execute

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/execute
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Request body

bindingstring required

Binding name or ID to execute against

intent_typestring required

Type of execution intent (e.g. http_request, graphql_query)

execution_mode'vault' | 'tee'

Where execution runs (vault = server-side, tee = Shroud TEE)

paramsobject required

Intent-specific parameters

dry_runboolean

When true, validate guardrails and approval policy without executing or persisting side effects.

Response

Execution result

execution_idstring uuid required
statusstring required
resultobject nullable
errorstring nullable
duration_msinteger required
redactions_appliedinteger required
execution_surface'vault' | 'tee'

Where the intent actually ran. Reported truthfully — never claims TEE when it ran in the Vault.

Changes

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