agentc
GitHubagentc-sh/agentc
agentc
GitHubagentc-sh/agentc
›Introduction
Get started›Concepts in 5 minutes›Build your first agent›Add your first tool›Serve and connect
Concepts›Architecture overview›The manifest›The compilation pipeline›Archetypes›The graph›Tools and capabilities›Runtime libraries›Skills›Agents and prompts›Serving and protocols›Observability
Guides›Author a manifest›Write a tool›Give your agent a filesystem›Control network egress›Connect external tools via MCP›Connect agents via A2A›Use the bash tool›Control tool access with capabilities›Write templated prompts›Manage prompts with Langfuse›Pass context from the client›Configure a model provider›Connect a CopilotKit frontend›Deploy a standalone binary›Deploy with Docker and PostgreSQL›Instrument with OpenTelemetry›Extend code generation with blocks
Reference
Manifest
Runtime
ReAct
HTTP
›Sessions›Messages›Runs›Checkpoints
›Prompt templates›State
›Observability

Checkpoints

The native HTTP endpoint for finding a session's checkpoints.

A checkpoint is a saved point in a run's execution, linked to the checkpoint before it by parent_checkpoint_id. Checkpoints are persisted so a client can list them and pass a checkpoint ID as checkpoint_id when starting a run.

Find checkpoints for a session

Find checkpoints for a session with optional filtering and pagination.

GET/v1/sessions/{session_id}/checkpoints

Find checkpoints for a session with optional filtering and pagination.

Path parametersin: path
session_id
string

The session ID.

Query parametersin: query
per_page
integer | nulldefault: 100

Maximum page size.

page
string | null

Opaque cursor for the next page.

ids
string[] | null

Checkpoint IDs to filter on.

run_ids
string[] | null

Run IDs to filter on.

reasons
string[] | null

Checkpoint reasons to filter on. One of input, step, interrupt, or finish.

statuses
string[] | null

Run statuses to filter on.

created_before
string | null

Filter by creation time.

created_after
string | null

Filter by creation time.

Responses

curl "http://localhost:8080/v1/sessions/8f3e19d8-3bc0-4fd5-bb02-7ac89af9d7bc/checkpoints" \
  -H "X-Tenant-ID: acme"
← PreviousRunsNext →Prompt templates

© 2026 pogue.dev. All rights reserved.

Creative CommonsCC BY 4.0
On this pageFind checkpoints for a session

Search docs

Search the agentc documentation