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

# bead organization membership

> Manage bead organization membership by claiming an agent workspace, inspecting members, and managing ownership.

Manage bead organization membership for the organization that owns your machines, credentials, and prepaid balance. Claim an agent-created workspace to manage that same organization from the dashboard.

## Claim a workspace

Use an admin-scoped credential:

```bash theme={null}
bead account claim-link
```

The response contains a private URL, organization ID, and `expires_in: 1800`. Give the URL to the intended owner. They sign in with GitHub at [app.bead.run](https://app.bead.run) and confirm the claim.

The link is single use and expires after 30 minutes. A claim grants ownership of the existing workspace. It adds no credit and does not lift trial restrictions.

## Members and ownership history

Admin-scoped customer API operations let you inspect membership and its history:

```bash theme={null}
bead api GET /account/members
bead api GET /account/events
```

Use the member identifier returned by the API to revoke membership:

```bash theme={null}
bead api DELETE /account/members/USER_ID
```

The API refuses removal of the last owner with HTTP 409. Add another owner before removing that member. Revoked membership removes that human's authority for the organization.

## Account boundaries

Check the organization before approving a claim or changing members. A separate signup creates a separate workspace; signing into a human account does not automatically attach an agent's resources.

For CLI sign-in, see [Accounts and dashboard login](https://docs.bead.run/platform/accounts.md). For credential permissions, see [API keys and scopes](https://docs.bead.run/platform/api-keys.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.