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

# Organization Management

> Create and manage organizations, invite members, and assign roles in the Jinba Toolbox console

Organizations are the top-level ownership unit in Jinba Toolbox. Every ToolSet, API key, and execution record belongs to an organization. You must create or join an organization before you can start building tools.

## Creating an Organization

<Steps>
  <Step title="Open the Dashboard">
    After signing in, navigate to the **Dashboard** page. You will see a list of organizations you belong to. If this is your first time, the list will be empty.
  </Step>

  <Step title="Click Create Organization">
    Click the **New Organization** button. A form will appear asking for:

    * **Name** -- A human-readable name for your team or project (e.g. "Acme Engineering").
    * **Slug** -- A URL-safe identifier auto-generated from the name (e.g. `acme-engineering`). You can customize it before creation.
  </Step>

  <Step title="Confirm Creation">
    Click **Create**. You will be redirected to the new organization's ToolSets page, ready to start building.
  </Step>
</Steps>

## Organization Dashboard

Once inside an organization, the sidebar provides access to all management areas:

<CardGroup cols={2}>
  <Card title="ToolSets" icon="toolbox">
    View, create, and manage your ToolSets. This is the default landing page for an organization.
  </Card>

  <Card title="Runs" icon="play">
    Browse the execution history of all tools within the organization.
  </Card>

  <Card title="Members" icon="users">
    Invite team members and manage their roles.
  </Card>

  <Card title="API Keys" icon="key">
    Create and revoke API keys scoped to this organization.
  </Card>

  <Card title="Credits" icon="coins">
    View your credit balance, purchase credits, and review transaction history.
  </Card>

  <Card title="Settings" icon="gear">
    Edit the organization name or delete the organization.
  </Card>
</CardGroup>

## Member Management

### Inviting Members

Only users with the **Owner** or **Admin** role can invite new members.

<Steps>
  <Step title="Navigate to Members">
    Go to **Members** in the organization sidebar.
  </Step>

  <Step title="Click Invite">
    Click the **Invite Member** button at the top of the page.
  </Step>

  <Step title="Enter Details">
    Provide the email address of the person you want to invite and select a role: **Owner**, **Admin**, or **Member**.
  </Step>

  <Step title="Send Invitation">
    Click **Send**. An invitation email will be sent. The pending invitation will appear in a separate section on the Members page until the user accepts it.
  </Step>
</Steps>

### Accepting an Invitation

When a user receives an invitation:

1. They click the link in the email, which opens the `/invite/[id]` page.
2. If they are not signed in, they are prompted to log in or sign up.
3. Once signed in, they click **Accept** to join the organization.
4. After acceptance, they are redirected to the organization page.

Invitations that are expired, cancelled, or sent to a different email address will display an error.

## Roles and Permissions

Each member is assigned one of the following roles:

| Permission                                | Owner | Admin | Member |
| ----------------------------------------- | ----- | ----- | ------ |
| Create / edit / delete ToolSets and Tools | Yes   | Yes   | Yes    |
| Execute and test tools                    | Yes   | Yes   | Yes    |
| View run history                          | Yes   | Yes   | Yes    |
| Manage API keys                           | Yes   | Yes   | No     |
| Invite and remove members                 | Yes   | Yes   | No     |
| Change member roles (below own level)     | Yes   | Yes   | No     |
| Edit organization settings                | Yes   | Yes   | No     |
| Delete the organization                   | Yes   | No    | No     |

<Note>
  Every organization must have at least one **Owner**. You cannot remove the last remaining owner.
</Note>

### Changing a Member's Role

Owners and Admins can change the role of any member whose current role is below their own. For example, an Admin can change a Member to Admin, but cannot change another Admin to Member.

### Removing a Member

Click the remove action next to a member's name on the Members page. A confirmation dialog will appear. Removal is immediate.

## Organization Settings

Navigate to **Settings** in the sidebar to:

* **Rename** the organization (Owner and Admin only).
* **Delete** the organization (Owner only). Deletion requires typing the organization name for confirmation and is irreversible -- all ToolSets, tools, versions, runs, and API keys will be permanently removed.

## Best Practices

* **Use organizations to group related teams or projects.** Each organization has its own ToolSets, API keys, and billing.
* **Follow the principle of least privilege.** Assign the minimum role needed for each member.
* **Review members regularly.** Remove access for users who no longer need it.
* **Keep at least two Owners** for redundancy in case one becomes unavailable.