Core workflow

Upload inboxes

Receive files from guests through a bounded inbox instead of email attachments.

Before you start

Select a workspace and project to receive the files.
Decide how long the inbox should accept uploads.

Create an inbox

guest upload inbox

blobyard inbox create "Support logs" --expires 24h

An inbox lets a guest upload into one project without a Blob Yard account. The capability URL is shown once. Without --expires an inbox lasts seven days, and the longest allowed lifetime is thirty days. The command uses the workspace and project stored by blobyard init, or explicit --workspace and --project flags.

Understand the bounds

A new inbox accepts up to 20 files and 1 GiB by default.
The file allowance can be raised to at most 10,000 files.
Each guest is rate limited to 20 uploads per hour.
Uploads land in the owning project as normal immutable versions.

List and revoke inboxes

inspect and revoke

blobyard inbox list
blobyard inbox revoke inbox_123

Listings show redacted metadata, not the raw capability URL. Revocation stops new uploads immediately while files already received stay in the project.

Reference and troubleshooting

Syntax and behavior

Reusable syntax

inbox syntax

blobyard inbox create <name> [--expires <duration>]
blobyard inbox list
blobyard inbox revoke <inbox-id>

Concrete example

one-day support inbox

blobyard --workspace demo-team --project release-files inbox create "Support logs" --expires 24h

Values used

Support logs: Public-facing inbox label, not a local directory.
24h: Inbox lifetime of one day. The maximum lifetime is thirty days.
inbox_123: Stable inbox identifier shown by inbox list.

Expected result

Create returns one public capability URL for guests. Listing later shows redacted metadata and usage counts only.

If it fails

Run inbox list to find the identifier before revoking.
Create a new inbox if the file or byte allowance filled up. Received files stay in the project.

Security and lifecycle

An inbox grants bounded upload access only. Guests never gain workspace access, downloads, or listings.