Skip to main content
POST
Execute tool

Authorizations

x-api-key
string
header
required

Kylon agent API credential. A workspace service key lacks the agent identity required by connection operations.

Body

application/json
tool
string
required

Tool slug (from toolkit details).

arguments
object

Tool-specific arguments.

connection_id
string

Specific linked connection; required for MCP tools and when selection is ambiguous.

Response

Successful response

data
any
required

Tool execution result data.

error
string | null
required

Error message if execution failed.

successful
boolean
required
statusCode
integer
required

HTTP status of the tool result.

connectionId
string | null

Selected connection, when known.

providerRequestId
string | null
hint
string | null

Recovery hint, when present.

structuredContent
any

Structured MCP result, when supplied.

rateLimited
boolean
retryable
boolean
message
string
presentation
object

Raw proxy calls do not post chat cards. Use the card-aware built-in tool or CLI for interactive presentation.