Sessions

Delete a session

Deletes one of your sessions (called a "notebook" in the product UI). This cannot be undone through the API. Files you uploaded into the session are deleted with it; files other people uploaded into it are kept, and every access grant this session gave out on a file is revoked. A session you do not own, or one already deleted, is 404. A 409 means a concurrent change touched one of those files mid-delete; nothing was deleted, so retry. An API key needs notebooks:write.

delete/api/sessions/{id}

Request

  • Base URL: https://your-deployment.example.com
  • URL: https://your-deployment.example.com/api/sessions/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Response

The session was deleted.

newLastNotebookIdstring nullable required

The caller's most recently updated remaining session, which the product UI opens next; null when none remains.

Changes

No recorded changes to this operation across all 1 revision of this API.