API reference · Agents

Get an agent

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

Returns one agent with its settings and its tools.

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

Path parameters

idstringRequired

The agent’s ID, such as ua_3f9a1c2b.

Response

agent.toolsobject[]

The tools switched on for the agent. With an agent’s own key each is cut down to id, name, description and kind.

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/agents/ua_3f9a1c2b" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"

Response · 200 OK

{
  "agent": {
    "id": "ua_3f9a1c2b",
    "userId": "usr_8c1d2e3f4a5b",
    "name": "Front desk",
    "costPerMinute": 0.07,
    "apiKey": "gs_agent_…",
    "webhookUrl": "",
    "systemInstruction": "You answer calls for Sunrise Dental…",
    "greetingMode": "generate",
    "greetingText": "",
    "greetingInstruction": "Greet {{customer_name}} warmly in one short sentence.",
    "voice": { "provider": "cartesia", "language": "en", "speaker": "…", "speed": 1 },
    "llm": { "provider": "…", "model": "…", "temperature": 0.6, "maxTokens": 90 },
    "stt": { "provider": "…", "language": "en", "detectLanguage": false },
    "variables": { "customer_name": { "defaultValue": "there" } },
    "toolIds": [],
    "tools": [],
    "systemTools": { "endCall": true },
    "stats": { "totalCalls": 0, "totalSeconds": 0, "totalCost": 0 },
    "createdAt": "2026-10-11T08:12:44.000Z",
    "updatedAt": "2026-10-11T08:12:44.000Z"
  }
}