List agents

GET

/v1/agents

GET

/v1/agents

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

1 {
2   "data": [
3     {
4       "capabilityCount": 5,
5       "config": {
6         "maxConcurrentRuns": 3,
7         "retryOnFailure": true,
8         "timeoutSeconds": 120
9       },
10       "createdAt": "2024-05-10T09:15:00Z",
11       "description": "Agent for automating customer support ticket triage",
12       "icon": "🤖",
13       "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
14       "name": "Support Triage Bot",
15       "primaryFlowId": "flow-9876543210",
16       "status": "active",
17       "updatedAt": "2024-06-01T15:00:00Z",
18       "lastRunAt": "2024-06-01T14:45:30Z"
19     }
20   ],
21   "pagination": {
22     "currentOffset": 0,
23     "hasMore": true,
24     "hasPrev": false,
25     "limit": 10,
26     "nextCursor": "cursor_abc123",
27     "prevCursor": null,
28     "currentPage": 1,
29     "totalCount": 25,
30     "totalPages": 3
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: <apiKey>" \
>	-H "Content-Type: application/json"

1	{
2	"data": [
3	{
4	"capabilityCount": 5,
5	"config": {
6	"maxConcurrentRuns": 3,
7	"retryOnFailure": true,
8	"timeoutSeconds": 120
9	},
10	"createdAt": "2024-05-10T09:15:00Z",
11	"description": "Agent for automating customer support ticket triage",
12	"icon": "🤖",
13	"id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
14	"name": "Support Triage Bot",
15	"primaryFlowId": "flow-9876543210",
16	"status": "active",
17	"updatedAt": "2024-06-01T15:00:00Z",
18	"lastRunAt": "2024-06-01T14:45:30Z"
19	}
20	],
21	"pagination": {
22	"currentOffset": 0,
23	"hasMore": true,
24	"hasPrev": false,
25	"limit": 10,
26	"nextCursor": "cursor_abc123",
27	"prevCursor": null,
28	"currentPage": 1,
29	"totalCount": 25,
30	"totalPages": 3
31	}
32	}