Skip to main content
GET
/
api
/
v1
/
agent
Get Agent
curl --request GET \
  --url https://sa.dialgen.ai/api/v1/agent \
  --header 'Authorization: Bearer <token>'
{
  "id": "agent_clx123abc...",
  "name": "Customer Support Agent",
  "createdAt": "2025-10-01T10:00:00.000Z",
  "updatedAt": "2025-10-05T14:30:00.000Z",
  "type": "OUTBOUND",
  "isActive": true,
  "basicDetails": {
    "dialId": "Dial2",
    "voiceId": "",
    "agent_name": "",
    "voiceSpeed": 0.7,
    "voiceGender": "male",
    "agentLanguage": "en"
  },
  "metricConfig": {
    "enabled": true,
    "customMetrics": []
  },
  "sipTrunkId": "sip_789"
}

Authorizations

Authorization
string
header
required

Bearer token authentication. Obtain your API key from the Dialgen API Keys dashboard at https://sa.dialgen.ai/api-keys

Query Parameters

agentId
string
required

The unique identifier of the agent

Example:

"agent_clx123abc..."

userId
string
required

The user ID owning the agent

Example:

"user_clx456def..."

Response

Agent details retrieved successfully

id
string

Unique agent identifier

name
string

Agent name

createdAt
string<date-time>

Agent creation timestamp

updatedAt
string<date-time>

Agent last update timestamp

type
enum<string>

Agent type

Available options:
OUTBOUND,
INBOUND
isActive
boolean

Whether the agent is active

basicDetails
object
metricConfig
object
sipTrunkId
string

SIP trunk identifier