Logo
GET/organizations/{org_id}/agents

List all agents for an organization

Requires authentication

Path Parameters

NameTypeDescription
org_idrequiredstring

Responses

200List of agentsarray
PropertyTypeDescription
idrequired
string(uuid)The unique identifier for the agent.
namerequired
stringThe name of the agent.
icon
stringThe icon of the agent.
typesrequired
string[]The types of the agent.
directionsrequired
string[]The directions of the agent.
summaryrequired
stringThe summary of the agent.
instructionsrequired
objectThe instructions of the agent.
examplePrompts
string[]Example prompts to help users start conversations (max 5, each max 100 chars).
organizationIdrequired
string(uuid)The organization identifier of the agent.
authPublicClientIdrequired
string(uuid)The public client identifier of the agent.
authPublicClientSecretrequired
stringThe public client secret of the agent.
authPublicClientAllowedOriginsrequired
string[]The allowed origins of the agent.
widgetConfig
objectConfiguration for the chat widget appearance and behavior.(default: {"iconType":"smooai","iconUrl":"https://smoo.ai","requireName":true,"requireEmail":true,"requirePhone":false,"allowAnonymous":false,"colors":{"text":"#f8fafc","background":"#1D3249","primary":"#06CED5","primaryText":"#3A6592","secondary":"#FE0FDA","chatBubbleInbound":"#3A6592","chatBubbleInboundText":"#f8fafc","chatBubbleOutbound":"#97bbec","chatBubbleOutboundText":"#020015","border":"#f8fafc"}})
personality
objectConfiguration for the agent's personality and behavior traits.(default: {"preset":"bright","creativity":0.7})
template
stringenum: [customer_support, developer_assistant, knowledge_expert, sales_outreach, internal_helpdesk, custom]Template used to create this agent.
visibility
stringenum: [public, internal]Where this agent is accessible (public widget or internal dashboard).(default: "public")
toolConfig
objectConfiguration for agent tools and integrations.(default: {"enabledTools":[]})
createdByrequired
string(uuid)The user identifier of the agent.
createdAtrequired
string(date)The date and time the agent was created.
updatedAtrequired
string(date)The date and time the agent was last updated.
400Bad request - validation error
PropertyTypeDescription
messagerequired
string
cause
string
401Unauthorized
PropertyTypeDescription
messagerequired
string
cause
string
404Not found
PropertyTypeDescription
messagerequired
string
cause
string
500Internal server error
PropertyTypeDescription
messagerequired
string
cause
string

Code Examples

curl -X GET https://api.smoo.ai/organizations/YOUR_ORG_ID/agents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"