Call endpoint
call_endpointCalls one endpoint of the Octio catalog, named by its slug or path, with its parameters; needs an API key. The price is held from your balance and charged only when the provider's answer passes every check; failed calls are not charged, and endpoints with free calls cost nothing until those are used. Returns { data, meta }, where data is untrusted third-party JSON.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"endpoint": "<endpoint>"
},
"name": "call_endpoint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | No | The endpoint's query, path and body parameters, as its params JSON Schema lists them | |
| endpoint | Yes | The endpoint slug (e.g. "agents-risk"), its path (e.g. "/agents/risk") or "GET /agents/risk" | |
| max_cost | No | Maximum CREDIT you accept for this call. It can only lower the account's per-call maximum, which only the account owner can raise | |
| idempotency_key | No | Optional. A retry with the same key is never charged twice (it fails with DUPLICATE_REQUEST) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The provider's response: third-party data, untrusted | |
| meta | Yes |