Settings

The Settings page has three tabs: Profile, API Keys, and Billing.

Profile

Shows your account information:

• Email — the address you signed up with.
• Display name — editable.
• Tier — "Free" or "Pro".
• Preserve metadata — toggle to keep EXIF/ID3/author fields in outputs. Pro only. Free users see a "Forge Pro only" tooltip.

Changes save automatically.

API Keys

Pro only

API keys are a Forge Pro feature. Upgrade to create keys.

Creating a key

1. Click New key.
2. Enter a name (e.g. "Zapier", "build-script") and select scopes.
3. Click Create.
4. The raw key (ff_live_…) is shown once — copy it immediately. After closing the dialog, the key is stored as a SHA-256 hash and cannot be recovered.

Scopes

Scope	Allows
convert:write	Create conversions
files:read	List and download files
files:write	Upload and finalize files
files:delete	Delete files

By default, new keys get convert:write and files:read.

Rotating a key

Click Rotate on any key row. This:

1. Revokes the existing key (immediate — any request using it will get 401).
2. Creates a new key with the same name and scopes.
3. Shows the new raw key once.

Revoking a key

Click Revoke and confirm. The key stops working immediately. This is idempotent — revoking an already-revoked key still returns 204.

Key details

Each key row shows:

• Name — your label for the key.
• Prefix — first 12 characters (e.g. ff_live_a1b2c3). This is the only part visible after creation.
• Scopes — which permissions the key has.
• Last used — timestamp and IP of the most recent request.
• Usage count — total conversions made with this key.
• Status — Active or Revoked.

Endpoints

The page also lists the public API endpoints you can call with a key:

GET    /v1/formats
POST   /v1/files/presign-upload
POST   /v1/files/{id}/finalize
POST   /v1/conversions
GET    /v1/conversions/{id}
GET    /v1/conversions/{id}/output

For full usage examples, see API → Examples.

Billing

Billing is not available during the v1.0.0 beta. The page shows a note pointing to the Pricing page and the email contact for manual Pro upgrades.

Self-serve Stripe checkout arrives in V2.