Get an agent

Retrieve the full configuration for a specific agent.

GET/api/external/v2/agents/:agent_id

Authentication

This endpoint authenticates with an API key via the X-API-Key header (ek_live_... format), instead of the bearer token used in the rest of the reference.

Path parameters

Parameter	Type	Required	Description
`agent_id`	String (UUID)	Required	UUID of the agent to retrieve.

Example request

bash

curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/agents/4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91" \
  -H "X-API-Key: ek_live_your_api_key_here"

Example response

json

{
  "agent": {
    "id": "4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91",
    "name": "Support Agent",
    "type": "BASIC",
    "system_prompt": "Help customers with clear and concise answers.",
    "tools": {
      "handoff_to_human_control": {
        "enabled": true,
        "instructions": "..."
      }
    }
  },
  "business_id": "2a4b8d4b-23fa-420a-94c2-cb9a4d2c7fb8"
}

Notes

The agent must belong to the business authenticated by the API key.
The response includes agent configuration, including prompts, model, tools, and related fields.