Skip to Content
OpenInspect
Administration

Data controls: archive and restore

How archiving a session works, how to restore archived sessions from Settings › Data Controls, and what deletion and export capabilities exist.

Last reviewed View as MarkdownEdit on GitHubGive feedback

Archiving takes a session out of the inbox and the sessions list without deleting it; Settings › Data Controls is where you find archived sessions and bring them back.

Settings, Data Controls: the Archived chats list with a title, age, and repository per row
Settings › Data Controls lists archived sessions so you can restore them.

Prerequisites

  • Archiving and restoring require sessions.lifecycle and lifecycle access to the specific session. Team-owned sessions require current owning-team membership, even for Owners and Administrators. Viewers can see readable archived sessions but do not get the Unarchive button. Private access rules also apply; see Multiplayer and sharing.

Archiving a session

You can archive from the session page's action bar (Archive) or from a session's action menu in the sessions list. Either way a confirmation dialog opens:

Archive session Archive this session? You can restore archived sessions from Settings > Data Controls.

Click Archive to confirm or Cancel to keep the session.

What archiving does:

  • The session's status becomes archived. It disappears from the inbox and from the default sessions list, which exclude archived sessions.
  • The session can no longer be prompted. Archived is not a promptable status, and follow-ups are refused until the session is restored.
  • The session's history, diffs, pull requests, and attribution are kept.
  • Archiving requests a preserve-and-stop shutdown rather than leaving the sandbox running until its inactivity timeout. State capture and provider shutdown may finish after the archive request returns, and either may fail. Queued or running work must finish or be stopped before archiving.

Two situations are refused:

SituationResult
The session is cancelled"Cancelled sessions cannot be archived." Cancelled is already a terminal state.
The session has queued or running work"Cannot archive a session with queued work." Wait for the turn to finish or stop it first.

In the web app a refused archive shows the toast "Failed to archive session".

Archiving a child session does not affect its parent. A child that is archived must be restored before its parent can send it another prompt; see Child sessions.

Batch archive

The web app has no multi-select for archiving. The control plane accepts a batch request, POST /sessions/batch-archive, for up to 25 sessions at a time, gated by the sessions.bulk_archive permission (Owner and Administrator). Each session in the batch is archived independently and reports its own outcome (archived, already_archived, skipped_cancelled, skipped_queued_work, not_found, or failed), so a refused session does not block the others. Sessions that failed can be retried on their own.

Restoring from Settings › Data Controls

Settings › Data Controls is described as "Manage your archived chats and data." Its Archived chats section lists readable archived sessions 20 at a time, with a Load more button when more exist. Each row shows the session title (or its repository when untitled), when it was last updated, and the repository.

Find the session

Open Settings › Data Controls. Click a row to open the archived session, or use Load more to page further back.

Unarchive it

Hover the row and click Unarchive. The toast "Session unarchived" confirms it, and the row leaves the list.

Continue the work

The restored session returns to whatever status its history implies (for example completed if its last turn finished) and can be prompted again. It reappears in the inbox and the sessions list.

You can also restore from the session page itself: an archived session's action bar shows Unarchive in place of Archive.

When nothing is archived the page reads "No archived sessions. Sessions you archive will appear here."

Deleting sessions

Sessions are archived, not deleted: the web app has no control to delete a session from the session page, the sessions list, or Settings › Data Controls. The permission sessions.delete exists (Owner, Administrator, Member) and the control plane exposes a delete operation that removes the session from the workspace index, but nothing in the web app calls it. Archiving is the supported way to retire a session from day-to-day views while keeping its record.

Session export

For operators and service integrations, the control plane exports paginated session traces as newline-delimited JSON, optionally including messages, events, and usage. Lines have a type: session for a complete record, session_error when an included trace cannot be read, cursor for the next page, or error if the stream fails. This is a best-effort export, not a consistent snapshot or reliable backup; check for errors and follow cursors before using it for offline analysis. There is no export page in the web app. See the self-hosting guide for how operators authenticate service calls.

Troubleshooting

Next steps

On this page