API reference · Tools

Get a tool

GEThttps://goblins-call-api.onrender.com/v1/tools/:id

Returns one tool as it is saved.

Needs a workspace API key.

Path parameters

idstringRequired

The tool’s ID, such as tool_5d2e8a41c07b.

Errors

404

No tool in your workspace has that ID.

Every request can also answer 401, 429 and 500: see Errors.

curl "https://goblins-call-api.onrender.com/v1/tools/tool_5d2e8a41c07b" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"

Response · 200 OK

{
  "tool": {
    "id": "tool_5d2e8a41c07b",
    "userId": "usr_8c1d2e3f4a5b",
    "agentId": "ua_3f9a1c2b",
    "name": "check_order_status",
    "description": "Looks up an order by its number, which the caller reads out. Use it when the caller asks where their order is.",
    "kind": "during_call",
    "method": "GET",
    "url": "https://your-app.com/api/orders/{{order_id}}",
    "timeoutMs": 5000,
    "params": [{ "key": "order_id", "value": "A-1042" }],
    "headers": [],
    "auth": "bearer",
    "authToken": "…",
    "outputs": [{ "name": "status" }, { "name": "eta" }],
    "createdAt": "2026-10-11T08:20:03.000Z",
    "updatedAt": "2026-10-11T08:20:03.000Z"
  }
}