HTTP APIAPI
Restore a checkpoint
Replaces local session state with a specific checkpoint from external storage. Requires a management token and settled local execution.
POST
/sessions/{id}/restoreAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Opaque session ID.
Match
^[a-fA-F0-9]{32}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/sessions/string/restore" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "checkpoint": "string" }'{ "checkpoint": { "id": "string", "offset": 0, "time": "2019-08-24T14:15:22Z" }, "config": { "bindings": [ { "alias": "string", "executor": "string", "operations": [ "string" ], "parameters": null, "provider": "string", "runtime": [ { "description": "string", "input_schema": null, "name": "string", "output_schema": null } ] } ], "instructions": "string", "model": "string", "reasoning_effort": "string", "tools": [ "string" ] }, "created_at": "2019-08-24T14:15:22Z", "credential_bindings": [ "string" ], "descriptors": [ { "description": "string", "input_schema": null, "name": "string", "output_schema": null } ], "harness": "string", "id": "string", "status": "string", "updated_at": "2019-08-24T14:15:22Z"}Flush external state POST
Uploads local event history and the latest completed checkpoint to external storage and returns the resulting checkpoint reference. Requires a management token and configured persistence.
Resume a session POST
Moves an interrupted or failed session back to idle from its last completed checkpoint. Requires a management token. Send a new user.message after resuming to continue the conversation.