Get Agent

GET 
/conversation-ai/agents/:agentId

Retrieves a specific AI agent by its ID. Returns the complete agent configuration including name, status, actions, and settings.

Request

Version stringrequired

API Version

Available optionsv3

agentId stringrequired

Conversations AI agent id

application/json

Successful response

application/json

Schema

Schema

idstringrequired

Unique identifier for the agent.

namestringrequired

Name of the agent.

businessNamestring

Name of the business the agent represents.

modestringrequired
Current operating mode of the agent.
Available optionsoffsuggestiveauto-pilot
channelsstring[]required
Communication channels the agent operates on.
Available optionsIGFBSMSWebChatWhatsAppLive_Chat
waitTimenumberrequired

Wait time before agent responds.

waitTimeUnitstringrequired
Unit for wait time.
Available optionsminutesseconds
sleepEnabledbooleanrequireddeprecated

Indicates if sleep functionality is enabled.

sleepTimenumber

Duration of sleep period.

sleepTimeUnitstring
Unit of sleep time.
Available optionshoursminutesseconds
actionsobject[]required

List of actions associated with this agent.

isPrimarybooleanrequired

Indicates if this agent is a primary agent.

autoPilotMaxMessagesnumberrequired

Maximum number of messages in auto-pilot mode before requiring human intervention.

goalstring

The goal of the agent.

personalitystring

Personality traits of the agent.

instructionsstring

Instructions for the agent.

knowledgeBaseIdsstring[]

Array of knowledge base IDs associated with this agent.

sleepOnManualMessageboolean

Whether the bot sleeps on manual outbound messages.

sleepOnWorkflowMessageboolean

Whether the bot sleeps on workflow outbound messages.

Example (auto)

{
  "id": "emp_123",
  "name": "John Doe",
  "businessName": "Tech Corp",
  "mode": "auto-pilot",
  "channels": [
    "SMS",
    "Live_Chat"
  ],
  "waitTime": 30,
  "waitTimeUnit": "seconds",
  "sleepTime": 2,
  "sleepTimeUnit": "hours",
  "actions": [
    {
      "id": "actionId123",
      "type": "triggerWorkflow"
    }
  ],
  "isPrimary": false,
  "autoPilotMaxMessages": 25,
  "goal": "Assist customers with inquiries",
  "personality": "Friendly and helpful",
  "instructions": "Provide excellent customer service",
  "knowledgeBaseIds": [
    "kb_123",
    "kb_456"
  ],
  "sleepOnManualMessage": false,
  "sleepOnWorkflowMessage": false
}