call_api
Invoke provider APIs with stored secrets by name; the broker injects real credentials and returns scrubbed responses.
Instructions
Call a provider API using a stored secret by name. The broker injects the real credential; you only see the (scrubbed) response. Paths are relative to the provider, e.g. secret="stripe-live", method="GET", path="/v1/customers?limit=3". For generic secrets and providers that span many hosts (AWS: upstream="https://s3.eu-west-1.amazonaws.com") pass upstream="https://host".
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": {
"secret": "<secret>",
"method": "<method>",
"path": "<path>"
},
"name": "call_api"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON object (sent as application/json) or a string sent as-is | |
| path | Yes | path with optional query, starting with / | |
| method | Yes | ||
| secret | Yes | ||
| headers | No | ||
| upstream | No | only for generic secrets: https://host[:port] |