{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Synchronous: blocks until the capture reaches READY and returns the terminal Checkpoint — clients never see PENDING on this endpoint and need no poll loop. The checkpoint binds the machine-state capture to the event-log cursor at the cut, so it can later seed forks (POST .../fork) and rollback. Checkpoints are taken between turns; a session with an active turn in flight returns 409.","properties":{"path":{"type":"object","properties":{"session_id":{"type":"string","examples":["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],"description":"The session UUID."}},"required":["session_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/create_checkpoint_request"}},"required":["path"],"additionalProperties":false,"definitions":{"create_checkpoint_request":{"type":"object","properties":{"label":{"type":"string","description":"Optional human-readable label stored on the checkpoint; \"\" if omitted."}}}}},"name":"CreateCheckpoint captures the session's live sandbox state as a durable checkpoint.","id":"digitalocean.harness_create_session_checkpoint","example":{"path":{"session_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}},"maxRequests":1,"summary":false}}