ReferenceHTTP APIPush requests
List the session's push requests
GET
Every push request of the session, newest first, with its state and who requested and resolved it.
Scope: sessions:read (API key or cookie session).
header
AuthorizationBearer <token>For servers and scripts: an API key sent as an HTTP bearer token, Bearer <key>. It holds exactly the scopes it was issued with; a key issued before scopes existed holds none. It never needs the CSRF header, and it cannot manage agents, members, teams or API keys. Issue one in the web console under Settings → API keys; each operation names the scope it needs.
Scope: sessions:read
id*stringThe session's id.
Match
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidThe session's push requests.
application/json- response
items*array<>intents*array<>Default
[]curl -X GET 'https://example.com/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/push-requests'Example Response
{ "items": [ { "id": "5b9e2c17-4f3a-4d6e-8a1b-7c0d9e2f3a41", "session_id": "0f8b6a52-3d1e-4c7a-9b2f-5e6d7c8a9b01", "repository_id": "sample-app", "checkpoint_revision": 3, "git_commit": "4f2a9c1e7b3d5a8f0c6e2b9d1a4f7c3e5b8d0a2c", "target_branch": "agent/0f8b6a52-3d1e-4c7a-9b2f-5e6d7c8a9b01", "state": "requested", "requested_by": { "principal": { "kind": "user", "id": "3e7f1a90-5c2d-4b8e-8f61-2a9d0c4b7e35" }, "actor_user_id": "3e7f1a90-5c2d-4b8e-8f61-2a9d0c4b7e35", "agent_id": null }, "requested_at": "2026-10-11T08:30:00Z", "resolved_by": null, "resolved_at": null, "resolution_reason": null, "request_receipt_id": "c4a1e9d2-7b3f-4e8a-a6c5-1d2e3f4a5b6c", "resolution_receipt_id": null, "finished_at": null, "push_receipt_id": null } ]}