List Agents

List all agents for the authenticated user. Uses cursor-based pagination.

GET

/api/v1/agents

Pro+

Query Parameters

Name	Type	Required	Description
limit	integer		Max items per page (1-100). Default: 20
cursor	string		Cursor from previous response for next page

Response Schema

Name	Type	Required	Description
agents	array	Required	List of agent objects
nextCursor	string \| null	Required	Cursor for next page, or null if no more

Each agent includes: id, name, botName, botAvatar, websiteUrl, status, chatbotType, gpt4, createdAt, updatedAt.

json

{
  "agents": [
    {
      "id": 123,
      "name": "Support Bot",
      "botName": "Support Bot",
      "botAvatar": "https://...",
      "websiteUrl": "https://example.com",
      "status": "listed",
      "chatbotType": "chatbot",
      "gpt4": false,
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-02-20T14:30:00.000Z"
    }
  ],
  "nextCursor": "124"
}

Code Examples

curl -X GET "https://chatspark.io/api/v1/agents?limit=20" \
  -H "Authorization: Bearer cs_live_..."

Send Message

Get Agent