Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Checkpoints/GET /harness/sessions/{sessionId}/checkpoints
GET /harness/sessions/{sessionId}/checkpoints
List checkpoints
Auth: required. Send an
ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.Returns checkpoint history for this session, ordered by creation time descending. Use source to filter by what triggered the checkpoint.
Request
Path parameters
sessionIdstring (uuid)
Session UUID (UUIDv7 — time-ordered)
Query parameters
limitinteger
sourceenum ("message" | "manual" | "sync" | "job_complete" | "subagent" | "tool_execution")
Filter by checkpoint source
Responses
200 OK
Checkpoints listed
Response shape:
checkpointsobject[]
totalinteger
401 Unauthorized
Authentication required
Response shape: object
404 Not Found
Resource not found
Response shape: object
Was this page helpful?