Skip to main content
POST
Proxy request

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
toolkit
string
required

Toolkit slug.

method
string
required

HTTP method.

url
string
required

Full URL on the native toolkit's allowed origin. For custom API-key connections it must match the configured HTTPS base URL origin.

headers
object

Additional HTTP headers.

body
any

Request body (for POST/PUT/PATCH).

connection_id
string

Specific linked native connection. Required when more than one matches the toolkit.

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.