Logo
Search
Docs

List agents

GET https://app.sulus.ai/api/v1/agents

List agents you can access

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Query parameters

per_page integer Optional Default: 50

Items per page.

Validation: integer, clamped 1–100
q string Optional Nullable

Search filter.

Validation: string (name/description contains-filter)
sort string Optional Default: updated

Sort order.

Validation: in: updated, name

Errors

StatusMeaningBody
401 Missing or invalid bearer token
403 Feature ai_chat not enabled for the account 
curl --request GET \
  --url https://app.sulus.ai/api/v1/agents \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
import requests

url = "https://app.sulus.ai/api/v1/agents"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}

response = requests.get(url, headers=headers)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://app.sulus.ai/api/v1/agents"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
Response 200 
{
    "object": "list",
    "data": [
        {
            "id": "a1b2c3d4-0000-4000-8000-000000000001",
            "object": "agent",
            "name": "Support Agent",
            "description": "Answers customer support questions.",
            "instructions": "Be concise and friendly.",
            "memory": "The customer prefers email follow-ups over phone calls.",
            "created_at": "2026-06-01T14:32:07.000000Z",
            "last_activity_at": "2026-07-29T09:15:44.000000Z"
        },
        {
            "id": "c9d8e7f6-0000-4000-8000-000000000009",
            "object": "agent",
            "name": "Sales Agent",
            "description": null,
            "instructions": null,
            "memory": null,
            "created_at": "2026-07-10T08:00:00.000000Z",
            "last_activity_at": null
        }
    ]
}