List agents

GET

/v1/agents

GET

/v1/agents

$ curl https://api.runtype.com/v1/agents \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "id": "a3f1c9e2-7b4d-4f8a-9d2e-5b6c7d8e9f01",
5       "name": "Sales Assistant",
6       "description": "AI agent that helps with lead qualification and follow-ups",
7       "icon": "🤖",
8       "primaryFlowId": "flow-12345abcde",
9       "config": {
10         "language": "en-US",
11         "timezone": "America/New_York",
12         "maxConcurrentTasks": 5
13       },
14       "status": "active",
15       "createdAt": "2024-05-10T09:15:00Z",
16       "updatedAt": "2024-06-01T12:00:00Z",
17       "capabilityCount": 12,
18       "lastRunAt": "2024-06-10T14:45:00Z"
19     }
20   ],
21   "pagination": {
22     "nextCursor": "cursor_abcdef123456",
23     "prevCursor": "cursor_123456abcdef",
24     "hasMore": true,
25     "hasPrev": true,
26     "limit": 20,
27     "currentOffset": 20,
28     "totalPages": 5,
29     "currentPage": 2,
30     "totalCount": 100
31   }
32 }

Get all agents for the authenticated user with filtering and cursor pagination.

List agents

List agents

Authentication

Query parameters

Response

Errors

Authentication

Query parameters

Response

Errors

$	curl https://api.runtype.com/v1/agents \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

1	{
2	"data": [
3	{
4	"id": "a3f1c9e2-7b4d-4f8a-9d2e-5b6c7d8e9f01",
5	"name": "Sales Assistant",
6	"description": "AI agent that helps with lead qualification and follow-ups",
7	"icon": "🤖",
8	"primaryFlowId": "flow-12345abcde",
9	"config": {
10	"language": "en-US",
11	"timezone": "America/New_York",
12	"maxConcurrentTasks": 5
13	},
14	"status": "active",
15	"createdAt": "2024-05-10T09:15:00Z",
16	"updatedAt": "2024-06-01T12:00:00Z",
17	"capabilityCount": 12,
18	"lastRunAt": "2024-06-10T14:45:00Z"
19	}
20	],
21	"pagination": {
22	"nextCursor": "cursor_abcdef123456",
23	"prevCursor": "cursor_123456abcdef",
24	"hasMore": true,
25	"hasPrev": true,
26	"limit": 20,
27	"currentOffset": 20,
28	"totalPages": 5,
29	"currentPage": 2,
30	"totalCount": 100
31	}
32	}