Archiving Threads

Over time, you accumulate threads from past investigations. Archiving lets you clean up your sidebar while preserving the conversation history for future reference.

Archiving a thread

Archived threads are removed from the sidebar but remain accessible through Settings. You can archive threads you no longer need immediate access to but want to keep for reference.

From the sidebar

1. Hover over a thread in the sidebar.
2. Click the menu icon (three dots) that appears.
3. Select Archive.

The thread immediately disappears from the sidebar.

From the command palette

1. Focus a thread in the sidebar using keyboard navigation.
2. Open the command palette with Cmd+K (Mac) or Ctrl+K (Windows/Linux).
3. Type "archive" and select the Archive action.

Using the API

Update the thread status to archived:

curl -X PATCH https://api.sazabi.com/threads/{threadId} \
  -H "Authorization: Bearer $SAZABI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "archived"}'

Viewing archived threads

Archived threads are accessible from project settings.

1. Open project settings from the sidebar.
2. Navigate to Archived threads.
3. Browse the list of archived threads with their titles and archive dates.

The list supports pagination for projects with many archived threads.

Restoring archived threads

Restoring an archived thread returns it to the sidebar with its full conversation history intact.

From settings

1. Go to Settings > Archived threads.
2. Find the thread you want to restore.
3. Click Unarchive.

The thread reappears in the sidebar in its original section (Team or Personal).

Using the API

Update the thread status back to regular:

curl -X PATCH https://api.sazabi.com/threads/{threadId} \
  -H "Authorization: Bearer $SAZABI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "regular"}'

Listing threads by status

When listing threads programmatically, you can filter by status to retrieve only active or only archived threads.

CLI

# List active threads (default)
sazabi threads list

# List archived threads
sazabi threads list --status archived

API

# Active threads
curl "https://api.sazabi.com/threads?status=regular" \
  -H "Authorization: Bearer $SAZABI_TOKEN"

# Archived threads
curl "https://api.sazabi.com/threads?status=archived" \
  -H "Authorization: Bearer $SAZABI_TOKEN"

Thread visibility and archiving

Archiving respects thread visibility settings:

• Organization threads: Any team member can archive or unarchive.
• Private threads: Only visible to and archivable by the owner.

When you view archived threads in settings, you see both organization-wide archived threads and your own private archived threads.

What archiving preserves

Archived threads retain:

• Complete conversation history
• All messages, tool calls, and artifacts
• Thread title and metadata
• Visibility settings (organization or private)
• Fork relationships with other threads

The only change is the thread's status and its removal from the active sidebar.

Best practices

Archive completed investigations: Once you resolve an issue and no longer need quick access to the thread, archive it to reduce sidebar clutter.

Use descriptive titles: Before archiving, rename threads with clear titles. This makes them easier to find later in the archived threads list.

Review periodically: Occasionally review your archived threads to restore any that become relevant again.