HTTP APIAPI
Get a session
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.
GET
/sessions/{id}Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Opaque session ID.
Match
^[a-fA-F0-9]{32}$Response Body
application/json
application/json
curl -X GET "https://example.com/sessions/string" \ -H "Authorization: Bearer YOUR_TOKEN"{ "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"}Delete a session DELETE
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.
Close a session POST
Permanently closes a session and stops any active or queued work. Requires a management token. Event history remains readable.