> ## Documentation Index
> Fetch the complete documentation index at: https://repost.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Repost Workspace: Settings and Organization Overview

> The Repost workspace is where you manage your team, API tokens, billing plan, and organization-wide traffic metrics from the dashboard.

Your workspace is the organization boundary in Repost. Everything scoped to your team lives here: buckets, forwarders, event history, teammates, usage counters, and your subscription. The workspace area lets you manage access and billing without touching individual webhook streams.

## What the workspace area covers

The workspace surfaces answer organization-wide questions. While a bucket page focuses on one webhook stream, the workspace area covers the state of the whole organization.

<CardGroup cols={3}>
  <Card title="Dashboard" icon="layout-dashboard">
    Monitor request volume, error rate, forwarding success, bandwidth, status mix, request geography, and top buckets across a selected time range.
  </Card>

  <Card title="Team" icon="users" href="/docs/workspace/team">
    Invite teammates, assign roles, manage licensed seats, and handle pending invitations.
  </Card>

  <Card title="Plans & Billing" icon="credit-card" href="/docs/workspace/billing">
    Compare plans, switch subscriptions, open the billing portal, and review invoices.
  </Card>
</CardGroup>

## Who can manage workspace settings

Not every role has the same permissions in the workspace area. Understanding which actions belong to which role helps you know where to go and who to ask.

<Tabs>
  <Tab title="Owner">
    Owners have full control over the workspace. They can manage billing, change subscription plans, invite or remove team members, assign seats, create and revoke API tokens, and adjust any workspace setting. The workspace always protects at least one owner license so billing and access can always be recovered.
  </Tab>

  <Tab title="Admin">
    Admins can manage team membership, assign and revoke seat licenses, and create organization API tokens. They can also manage billing — including upgrading or downgrading the subscription and opening the billing portal — but cannot perform actions that require ownership transfer.
  </Tab>

  <Tab title="Member">
    Members work with buckets and forwarders. They can use the CLI with a personal or organization token, view event history, and create or manage their own forwarders. Members cannot invite teammates, manage billing, or assign seats.
  </Tab>
</Tabs>

## Reading the dashboard as a triage surface

Start at the workspace dashboard when you need a current health check for the whole organization. The aggregate cards surface the signal; you then navigate to the specific page where the action lives.

<Steps>
  <Step title="Choose a time range">
    Use the range selector to compare traffic across the window you care about — last hour, last 24 hours, or a custom range.
  </Step>

  <Step title="Spot the failing surface">
    Use the error rate, status mix, request geography, top buckets list, and failed forwarding count to identify which bucket or destination changed.
  </Step>

  <Step title="Navigate to the relevant page">
    Navigate to the bucket, forwarder history, team page, usage page, or billing page depending on what needs to change.
  </Step>

  <Step title="Keep workspace actions separate from ingestion actions">
    Use workspace pages for access, plan, and usage decisions. Use individual bucket and forwarder pages for webhook routing and delivery behavior.
  </Step>
</Steps>

<Note>
  The four dashboard summary cards show **Requests** (total accepted events), **Error rate** (share of 4xx and 5xx responses), **Forwarded** (successful delivery attempts), and **Bandwidth** (estimated payload bytes processed). Use these as starting points, not as the full picture.
</Note>

## Workspace guides

Each guide below covers one operational area and maps directly to what you see in the dashboard.

<CardGroup cols={3}>
  <Card title="Team and seats" icon="users" href="/docs/workspace/team">
    Invite members, assign roles, understand seat limits, and restore access after a plan change.
  </Card>

  <Card title="API tokens" icon="key-round" href="/docs/workspace/tokens">
    Create personal and organization tokens for CLI use, CI jobs, and shared automation.
  </Card>

  <Card title="Account security" icon="shield-check" href="/docs/workspace/account-security">
    Manage your password, security settings, and active sessions from Account Settings.
  </Card>

  <Card title="Plans & billing" icon="credit-card" href="/docs/workspace/billing">
    Upgrade, switch billing interval, handle downgrades, and open the billing portal.
  </Card>

  <Card title="Usage" icon="activity" href="/docs/workspace/usage">
    Track current event consumption, quota limits, per-bucket breakdown, and overage.
  </Card>
</CardGroup>