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

> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.

# Seats

> Assign your subscription's seats to specific members and revoke them when people move on.

A seat is what gives a member the benefits of your team subscription tier. Seats you haven't assigned just sit in the org pool until you hand them out.

The Seat Management table lives on the **Subscription** tab of the [Billing page](https://account.qbraid.com/organizations/billing).

## Assign a seat

<Steps>
  <Step title="Switch to your organization">
    Open the workspace switcher in the top-left of the dashboard and select your
    organization.
  </Step>
  <Step title="Open Billing">Click **Billing** in the sidebar.</Step>
  <Step title="Stay on the Subscription tab">It's the default tab.</Step>
  <Step title="Scroll to Seat Management">
    The table sits below the subscription card.
  </Step>
  <Step title="Open the assign dialog">
    Click **Assign** on an unassigned seat row (or **Assign Seat** on a member's
    row).
  </Step>
  <Step title="Pick a member">Choose them from the dropdown.</Step>
  <Step title="Confirm">Click **Assign Seat**.</Step>
</Steps>

<Check>
  The member gets tier benefits right away. If you've turned on
  credits-on-assign in [Settings](https://docs-v2-staging.qbraid.com/v2/account/organizations/settings), they also
  receive a credit transfer at the same time.
</Check>

<Tip>
  Turn on **Auto-assign Seats** in
  [Settings](https://docs-v2-staging.qbraid.com/v2/account/organizations/settings) and new members get a seat
  automatically when they accept their invite (as long as one is available).
</Tip>

## Revoke a seat

<Steps>
  <Step title="Switch to your organization">
    Open the workspace switcher and select your organization.
  </Step>
  <Step title="Open Billing">Click **Billing** in the sidebar.</Step>
  <Step title="Stay on the Subscription tab">It's the default tab.</Step>
  <Step title="Scroll to Seat Management">
    The table sits below the subscription card.
  </Step>
  <Step title="Click Revoke">On the member's row.</Step>
  <Step title="Confirm">Confirm in the dialog.</Step>
</Steps>

The seat goes back to the pool and you can give it to someone else. The member loses tier benefits but keeps any credits already in their wallet.

<Frame>
  <video
    src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/orgs/revoke-seat.mp4"
    autoPlay
    muted
    loop
    playsInline
    aria-label="Revoking a seat"
  />
</Frame>

## How seats and members interact

| Action                                             | Effect on seat                                                                        |
| -------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Member accepts invite (with Auto-assign Seats on)  | A seat is assigned automatically if one is available.                                 |
| Member accepts invite (with Auto-assign Seats off) | They join without a seat. Assign manually later.                                      |
| Admin removes a member                             | Their seat returns to the pool.                                                       |
| Admin suspends a member                            | Their seat returns to the pool. Reassigning when they're reactivated isn't automatic. |
| Subscription is canceled (period ends)             | All assigned seats are revoked at the same time.                                      |
| Admin adds seats to the subscription               | New unassigned seats land in the pool.                                                |

## Need more seats?

Adding seats is a billing action, not a member action. See [Subscriptions > Add more seats](https://docs-v2-staging.qbraid.com/v2/account/organizations/subscriptions#add-more-seats).