GET /tools
Updated Oct 1, 20261 minute read
List tools
Every tool this organization has wired up, switched on or not, with the endpoint answering each. GET /conversations/{id}/tools is the same list narrowed to what one thread could reach; this is the settings page's view.
Part of Tool approvals.
Responses
| Status | Description |
|---|---|
200 | The tools. |
401 | The bearer token is missing, revoked, or expired. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
tools | object[] | No | |
tools[].name | string | No | |
tools[].description | string | No | |
tools[].risk | "low" | "medium" | "reviewed" | "high" | No | |
tools[].enabled | boolean | No | |
tools[].endpointId | string | No | |
tools[].endpointUrl | string | No | |
tools[].endpointStatus | string | No | |
tools[].endpointError | any | No | |
tools[].inputSchema | string | No | The arguments it takes, as a serialized JSON Schema. |
Example request
curl https://api.median.sh/v1/tools \
-H "Authorization: Bearer $BEARER_AUTH"