Delete a session
Settles execution, revokes executors, and removes local private state, events, native files and online checkpoints. A retained tombstone prevents restoration. Repeat after a failed cleanup; success means online cleanup completed. Independently retained backups follow their retention policy.
/sessions/{id}Authorization
bearer In: header
Path Parameters
Opaque session ID.
^[a-fA-F0-9]{32}$Response Body
application/json
application/json
curl -X DELETE "https://example.com/sessions/string" \ -H "Authorization: Bearer YOUR_TOKEN"{ "status": "string"}Create a session POST
Creates a session for the caller's tenant with the given harness, model, instructions, reasoning effort, and tools. Requires a management token. Creating a session records its metadata locally; the harness process starts when the first message is sent.
Get a session GET
Returns metadata and current status for a session. If the session is not on local disk and external storage is configured, Brain loads the latest published checkpoint.