GET /conversations/{id}/tools
Updated Oct 1, 20261 minute read
List runnable tools
Every switched on tool a run could reach from this conversation, with the JSON Schema its input is checked against.
Part of Tool approvals.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | A conversation id. |
Responses
| Status | Description |
|---|---|
200 | The tools, sorted by name. |
401 | The bearer token is missing, revoked, or expired. |
404 | Not one of yours, or not there at all. |
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[].inputSchema | string | No | The tool's JSON Schema, serialized. |
Example request
curl https://api.median.sh/v1/conversations/id/tools \
-H "Authorization: Bearer $BEARER_AUTH"