Skip to main content
A drive is a container for files. Think of it like a folder or a project — each drive isolates its files from other drives.

​
When to create a drive

  • One drive per project (research-q1, marketing-assets)
  • One drive per agent (data-analyst, code-reviewer)
  • One drive per team (engineering, design)

​
Drive slugs

Claimed drives get a human-readable slug: username/drive-name. For example, alice/research-q1. Slugs can be used as an alternative to UUIDs wherever drive_id is accepted:
You can also look up a drive by slug:
Unclaimed drives (provisioned by agents but not yet claimed) have no slug — only a UUID.

​
Drive lifecycle

Unclaimed drives auto-delete after 30 days. Claiming a drive (via the claim URL) removes the expiry and activates the slug.

​
Drive limits

​
Drive metadata

Each drive tracks:
  • file_count — Number of files in the drive
  • total_size — Total storage used (bytes)
  • slug — Human-readable identifier (null if unclaimed)
  • expires_at — Auto-deletion date (null if claimed)
  • created_at / updated_at — Timestamps
These counters update automatically as files are uploaded or deleted.