Generate and store a recovery packet for a crashed session
Generates a tiered recovery packet from the provided crash context and persists it to the database. Used by the dashboard when a session enters a failed state to capture enough context for resumption. Auth: WorkOS session cookie (`getUser()`). Dashboard/browser only.
Authorization
cookieAuth WorkOS AuthKit session cookie. Required by browser-facing dashboard routes (recovery-packet, recovery-chain). Not usable from CLI or programmatic callers without an active WorkOS browser session.
In: cookie
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/sessions/string/recovery-packet" \ -H "Content-Type: application/json" \ -d '{ "agentId": "string" }'{}{
"error": "Session not found"
}{
"error": "Session not found"
}{
"error": "Session not found"
}Fetch latest recovery packet for crash resumption
Returns the most recently generated recovery packet for this session. Pass `?resume=true` to additionally mark the packet as consumed so the chain does not re-use it. Auth: WorkOS session cookie (`getUser()`). Dashboard/browser only.
Get full recovery chain history for a session
Returns all recovery packets for the session ordered most recent first. Useful for visualizing the full crash→resume history. Auth: WorkOS session cookie (`getUser()`). Dashboard/browser only.