GET/api/v1/tools
Tools
List Tools
Returns user tool instances. Tools marked nonDisclose are hidden and credential values inside function config are redacted.
Request
Endpoint
GET
/api/v1/toolsAuthentication
x-api-keyorAuthorization: BearerResponse Example
response.json
{
"success": true,
"data": [
{
"id": "66aa2b3c4d5e6f7a8b9c0d11",
"name": "Get order status",
"description": "Looks up an order status from our backend.",
"when_to_call": "onCall",
"type": "apiRequest",
"function": {
"request_url": "https://api.example.com/orders/{order_id}",
"request_http_method": "GET",
"authentication": {
"type": "apiKey",
"apiKey": {
"key": "X-Api-Key",
"value": "***redacted***"
}
}
},
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-02T08:30:00.000Z"
}
]
}Status Codes
| HTTP | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 401 | Unauthorized | Missing, invalid, inactive, or origin-restricted API key. |
| 429 | Rate limited | Per-IP or per-key request budget was exceeded. |
Security Model
User-scoped by default
This endpoint only sees resources owned by the user attached to the API key. If another user's id is supplied, the API responds as if the resource does not exist.