execution

Execute a tool

Runs the named tool against the user's connected app. Write and destructive tools are refused with HTTP 412 unless the request sets "confirmed": true. When the user has several connections for one app, pass "connectionId" to pick one; omitting it uses the default connection. On failure, read "error.message" and "hint": they are written for agent self-correction.

post/api/tools/{name}/execute

Request

  • Base URL: https://claw-link.dev
  • URL: https://claw-link.dev/api/tools/{name}/execute
  • Auth: one of:
    • API key in header x-clawlink-api-key
    • HTTP bearer

Path parameters

namestring required

Request body

argumentsobject

Tool arguments matching the input schema from describeTool. If "arguments" is omitted, all top-level body fields except connectionId, confirmed, and files are treated as the arguments.

confirmedboolean

Required as true for write and destructive tools.

Response

Execution succeeded

okboolean required
resultunknown
dataunknown
hintstring

Actionable next step for the agent.

detailsstring[]
requiresConfirmationboolean
canonicalobject

Canonical execution summary.

Changes

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