Skip to main content
POST
Execute tool

Authorizations

Authorization
string
header
required

Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.

Path Parameters

toolId
string
required

The ID of the tool to execute

Example:

"Acme_CRM_get_customer"

Body

application/json
input
object
required

Arguments for the tool, shaped by ITS OWN input schema — read that from GET /v1/tools or GET /v1/tool-providers/{id} first. The example here is illustrative, not a fixed shape.

Example:

Response

The tool's own result

success
boolean
toolId
string
result
any

Whatever the tool returned, unchanged — shaped by that tool, not by this endpoint. An HTTP tool returns its upstream response body.

executionTime
integer

Milliseconds spent running it.