List Agent batch queries | Pyramid AI

Authentication

AuthorizationBearer

Pyramid API key (prefix with “Bearer ”)

Query parameters

project_idstringOptionalformat: "uuid"

limitintegerOptional<=200Defaults to 50

offsetintegerOptionalDefaults to 0

Response

List of batches

request_idstringformat: "uuid"

Server-generated per-request UUID. Also sent as X-Request-Id response header. Include in support tickets.

successany

datalist of objects

paginationobject

Offset-based pagination for list endpoints. Clients compute has_more from offset + data.length < total. Cursor pagination may be added per-endpoint later if deep-pagination performance becomes a concern.

Errors

400

Bad Request Error

401

Unauthorized Error

$	curl -G https://api.pyramid-ai.com/api/v2/agent/batches \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6 \
>	-d limit=50 \
>	-d offset=0

1	{
2	"request_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
3	"success": true,
4	"data": [
5	{
6	"id": "b1c2d3e4-f5a6-7890-bcde-f12345678901",
7	"name": "Q2 Safety Compliance Checklist",
8	"project_id": "7e9f1a2b-3c4d-5e6f-7890-123456abcdef",
9	"org_id": "org_ais",
10	"question_count": 25,
11	"created_at": "2026-05-22T10:00:00Z",
12	"trigger_run_id": "a9b8c7d6-e5f4-3210-abcd-9876543210fe"
13	}
14	],
15	"pagination": {
16	"total": 127,
17	"offset": 0,
18	"limit": 50
19	}
20	}