logo
AgentsList AI agents
Agents

List AI agents

Returns all active AI agents for the workspace (excludes soft-deleted agents). Sorted by creation date descending.

curl -X GET "https://api.sendkit.ai/v1/agents" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "_id": "664a1b2c3d4e5f6a7b8c9d0e",
      "name": "Sales Agent",
      "companyInfo": {
        "name": "Acme Inc"
      },
      "persona": {
        "tone": "professional",
        "role": "sales representative"
      },
      "isDefault": true,
      "usage": {},
      "createdAt": "2024-06-01T10:00:00.000Z"
    },
    {
      "_id": "664a1b2c3d4e5f6a7b8c9d0f",
      "name": "Support Agent",
      "companyInfo": {
        "name": "Acme Inc"
      },
      "persona": {
        "tone": "friendly",
        "role": "customer success manager"
      },
      "isDefault": false,
      "usage": {},
      "createdAt": "2024-06-02T10:00:00.000Z"
    }
  ]
}
GET
/v1/agents
GET
API Key (header: X-Api-Key)
X-Api-Keystring
Required

Platform API key (sk_user_...) or Workspace API key (sk_...)

Platform API key (sk_user_...) or Workspace API key (sk_...)
Bearer Token
Bearer Tokenstring
Required

API key as Bearer token

API key as Bearer token
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-Api-Keystring
Required

API Key for authentication. Platform API key (sk_user_...) or Workspace API key (sk_...)

header
Authorizationstring
Required

Bearer token. API key as Bearer token

Responses

successboolean
dataarray