pydo.harness.revert_session_checkpoint()

Generated on 6 Nov 2026 from pydo version v0.45.0

Usage

client.harness.revert_session_checkpoint(
    session_id="a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    checkpoint_id="cp_9f2c1a4b",
)
Returns JSON Raises HttpResponseError

Description

In-place restore: boots a fresh sandbox from the checkpoint and atomically swaps the session’s sandbox pointer to it, so the session keeps its same session_id; the old sandbox is then torn down.

Parameters

session_id string required

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

The session UUID.

checkpoint_id string required

Example: cp_9f2c1a4b

The checkpoint id.

Response Example

Show Response Example
{
  "session": {
    "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "demo-agent",
    "parent_session_id": "example",
    "fork_id": "11111111-2222-3333-4444-555555555555",
    "fork_from_checkpoint_id": "example",
    "agent_kind": "AGENT_KIND_UNSPECIFIED",
    "status": "SESSION_STATUS_UNSPECIFIED",
    "sandbox_id": "example",
    "created_at": "2026-08-01T12:00:00Z",
    "last_event_at": "2026-08-01T12:00:00Z",
    "keep_warm": false,
    "resume_on_topoff": false,
    "pause_reason": "example",
    "idle_timeout_seconds": 60,
    "repo_hint": "example",
    "warnings": [],
    "config_id": "11111111-2222-3333-4444-555555555555",
    "openai_session_id": "example",
    "openai_environment_id": "example",
    "region": "ric1",
    "workspace_id": "019a2f4e-8c1d-7b3a-9e5f-2d6c8a1b4e70"
  }
}

More Information

See /v2/agents/sessions/{session_id}/checkpoints/{checkpoint_id}/rollback in the API reference for additional detail on responses, headers, parameters, and more.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.