Skip to main content
GET
Get a specific agent by ID.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

agentId
string
required

Response

Agent details

Agent object

id
string

Agent ID

name
string

Agent name

avatarImage
string

URL or base64 avatar image

systemPrompt
string

AI system instructions

agentPrompt
string

Agent-specific prompt

customColors
object

Branding colors configuration

model
string

AI model

channelSettings
object

Multi-channel configuration

leadFields
object[]

Lead field definitions

contactListId
string

Smart list ID

aiContactCaptureEnabled
boolean

Whether AI passively extracts contact info from conversations

isActive
boolean

Whether agent is active

knowledgeBaseEnabled
boolean

Whether the agent answers from the knowledge base

knowledgeBaseScope
string

Knowledge base folder the agent is limited to (e.g. / or /shared/Support)

multiStepToolsEnabled
boolean

Whether the agent can chain multiple tool-calling turns (knowledge base search, MCP servers, integration toolsets) instead of a single round

multiStepMaxTurns
integer

Tool-calling turns allowed before tools are removed and the agent must answer (1-10, default 5)

shortCode
string

Shareable URL code

created
number

Creation timestamp

updated
number

Last update timestamp