API reference · Tools

List tools

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

Returns one agent’s tools, or every tool in your workspace when no agent is named.

Needs a workspace API key.

Query parameters

agentIdstringOptional

Only this agent’s tools.

userIdstringOptional

A workspace ID. A key belongs to one workspace, so this is never needed with one; naming another workspace answers 403.

Errors

404

No agent 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?agentId=ua_3f9a1c2b" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"
Response · 200 OK
{
  "tools": [
    {
      "id": "tool_5d2e8a41c07b",
      "agentId": "ua_3f9a1c2b",
      "name": "check_order_status",
      "kind": "during_call",
      "method": "GET",
      "url": "https://your-app.com/api/orders/{{order_id}}",
      …
    }
  ]
}