API reference · Agents

List agents

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

Returns every agent in your workspace, most recently edited first, each with how many calls it is on right now.

Works with a workspace API key or the agent’s own key.

Query parameters

userIdstringOptional

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

Response

agents[].activeCallsinteger

Calls this agent is on at the moment.

agents[].costPerMinutenumber

What a minute of this agent’s calls costs, in USD.

agents[].statsobject

Lifetime totals: totalCalls, totalSeconds and totalCost.

Notes

Each agent is the full object shown under Get an agent; the sample here is shortened.
With an agent’s own key the list holds that one agent.

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

Response · 200 OK

{
  "agents": [
    {
      "id": "ua_3f9a1c2b",
      "name": "Front desk",
      "costPerMinute": 0.07,
      "voice": { "provider": "cartesia", "language": "en", "speaker": "…" },
      "systemTools": { "endCall": true },
      "stats": { "totalCalls": 128, "totalSeconds": 20412, "totalCost": 23.81 },
      "activeCalls": 1,
      "updatedAt": "2026-10-11T08:12:44.000Z"
    }
  ]
}