Checkpoints

State snapshots and rollback functionality. Create checkpoints before risky operations, and restore to previous states if something goes wrong.

Create Checkpoint

Endpoint: POST /v1/checkpoints

Create a snapshot of the current agent state.

Request

POST /v1/checkpoints
Content-Type: application/json
X-API-Key: your-api-key

{
  "agent_id": "agt_abc123",
  "label": "before-migration",
  "metadata": {
    "reason": "Pre-migration backup"
  }
}

List Checkpoints

Endpoint: GET /v1/checkpoints

List all checkpoints for an agent.

Get Checkpoint

Endpoint: GET /v1/checkpoints/:id

Get a specific checkpoint with all saved state.

Restore Checkpoint

Endpoint: POST /v1/checkpoints/:id/restore

Restore agent state to a previous checkpoint.