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

# Organization

> Manage organization details, members, and permissions

Kasava uses Organizations to help your team collaborate on projects, repositories, and documentation.

## Accessing Organization Settings

To manage your organization:

1. Click your **avatar** in the sidebar
2. Select **Settings**
3. Click **Organization** in the left navigation

## Organization Overview

Your Kasava organization is where your team collaborates on:

* Connected GitHub repositories
* AI-powered code analysis
* Plans (Product Requirements Documents)
* Bug reports and tracking
* Documentation and workflows

## Organization Details

Update your organization's basic information:

| Field | Description                                 |
| ----- | ------------------------------------------- |
| Name  | Your organization's display name            |
| Slug  | Unique URL identifier for your organization |

The page also displays your current subscription tier and status.

<Steps>
  <Step title="Edit Details">
    Update the organization name or slug
  </Step>

  <Step title="Save Changes">
    Click "Save Changes" to apply updates
  </Step>
</Steps>

## Member Roles

Kasava supports three member roles with different permission levels:

| Role   | Permissions                                                                     |
| ------ | ------------------------------------------------------------------------------- |
| Owner  | Full access including billing, organization deletion, and ownership transfer    |
| Admin  | Member management, settings, integrations - cannot manage billing or delete org |
| Member | Full access to organization resources - cannot manage members or settings       |

### Role Capabilities

| Capability          | Owner | Admin | Member |
| ------------------- | ----- | ----- | ------ |
| View repositories   | Yes   | Yes   | Yes    |
| Index repositories  | Yes   | Yes   | Yes    |
| Create Plans        | Yes   | Yes   | Yes    |
| Use AI features     | Yes   | Yes   | Yes    |
| Manage integrations | Yes   | Yes   | No     |
| Invite members      | Yes   | Yes   | No     |
| Change member roles | Yes   | Yes\* | No     |
| Manage billing      | Yes   | No    | No     |
| Delete organization | Yes   | No    | No     |
| Transfer ownership  | Yes   | No    | No     |

\*Admins can change roles between Admin and Member only.

## Viewing Members

The Members section shows all organization members and pending invitations in a table view:

| Column  | Description                                 |
| ------- | ------------------------------------------- |
| Member  | Name, avatar, and whether it's your account |
| Email   | Member's email address                      |
| Role    | Current role with icon indicator            |
| Actions | Menu for role changes and removal           |

Pending invitations appear in the same table with:

* "Pending Invitation" status
* Expiration date
* Options to resend or cancel

## Inviting Members

To invite new members to your organization:

<Steps>
  <Step title="Open Organization Settings">
    Navigate to Settings > Organization
  </Step>

  <Step title="Click Invite">
    Click the "Invite" button in the Members section header
  </Step>

  <Step title="Enter Email">
    Enter the email address of the person you want to invite
  </Step>

  <Step title="Select Role">
    Choose either "Member" or "Admin" role
  </Step>

  <Step title="Send Invitation">
    Click "Send Invitation"
  </Step>
</Steps>

<Note>
  Invitations expire after 7 days. The invited user must have a Kasava account with the same email address to accept the invitation.
</Note>

### Managing Pending Invitations

For pending invitations, you can:

* **Resend** - Click the refresh icon to send a new invitation email
* **Cancel** - Click the X icon to cancel the invitation

## Changing Member Roles

Owners can change any member's role. Admins can change roles between Admin and Member.

<Steps>
  <Step title="Find the Member">
    Locate the member in the Members table
  </Step>

  <Step title="Open Actions Menu">
    Click the three-dot menu on the right
  </Step>

  <Step title="Select New Role">
    Choose "Change to Admin" or "Change to Member"
  </Step>
</Steps>

<Note>
  The organization Owner role cannot be changed. To change ownership, see "Transferring Ownership" below.
</Note>

## Removing Members

To remove a member from your organization:

<Steps>
  <Step title="Find the Member">
    Locate the member in the Members table
  </Step>

  <Step title="Open Actions Menu">
    Click the three-dot menu on the right
  </Step>

  <Step title="Click Remove">
    Select "Remove from organization"
  </Step>

  <Step title="Confirm">
    Confirm the removal in the dialog
  </Step>
</Steps>

<Warning>
  Removing a member immediately revokes their access to all organization resources. This action cannot be undone - they will need a new invitation to rejoin.
</Warning>

## Leaving an Organization

If you're not the owner, you can leave an organization:

<Steps>
  <Step title="Find Your Entry">
    Locate yourself in the Members table (marked with "(You)")
  </Step>

  <Step title="Open Actions Menu">
    Click the three-dot menu
  </Step>

  <Step title="Click Leave">
    Select "Leave Organization"
  </Step>

  <Step title="Confirm">
    Confirm that you want to leave
  </Step>
</Steps>

<Note>
  If you're the organization Owner, you must transfer ownership before leaving.
</Note>

## Transferring Ownership

Organization owners can transfer ownership to another member:

<Steps>
  <Step title="Find Your Entry">
    Locate yourself (the owner) in the Members table
  </Step>

  <Step title="Open Actions Menu">
    Click the three-dot menu
  </Step>

  <Step title="Click Transfer">
    Select "Transfer Ownership & Leave"
  </Step>

  <Step title="Select New Owner">
    Choose the member who will become the new owner
  </Step>

  <Step title="Confirm Transfer">
    Confirm the ownership transfer
  </Step>
</Steps>

<Warning>
  Transferring ownership gives the new owner full control including billing management and the ability to delete the organization.
</Warning>

## Usage Statistics

The Organization settings page displays your current resource usage:

| Metric     | Description                           |
| ---------- | ------------------------------------- |
| Repos      | Connected repositories vs. plan limit |
| Members    | Current team size                     |
| Syncs      | GitHub sync events this month         |
| Storage    | Document storage consumption          |
| AI Credits | Credits used vs. monthly allocation   |
| Indexing   | Repository indexing operations        |

Progress bars show usage percentage with color indicators:

* **Green** - Normal usage (under 80%)
* **Yellow** - Warning (80-89%)
* **Orange** - Critical (90-99%)
* **Red** - At or over limit

<Tip>
  Click "Upgrade" to increase your limits on the Billing page.
</Tip>

## Switching Organizations

If you belong to multiple organizations:

<Steps>
  <Step title="Click Your Avatar">
    Click your avatar in the sidebar
  </Step>

  <Step title="Hover on Switch Organization">
    Hover over "Switch Organization" in the dropdown
  </Step>

  <Step title="Select Organization">
    Click the organization you want to switch to
  </Step>
</Steps>

A checkmark indicates your currently active organization.

## Deleting an Organization

<Warning>
  Organization deletion is permanent and cannot be undone. All data including repositories, Plans, documents, and member associations will be lost.
</Warning>

Only organization Owners can delete an organization:

<Steps>
  <Step title="Go to Organization Settings">
    Navigate to Settings > Organization
  </Step>

  <Step title="Find Danger Zone">
    Scroll to the "Danger Zone" section at the bottom
  </Step>

  <Step title="Click Delete">
    Click the "Delete" button
  </Step>

  <Step title="Confirm">
    Type the organization name and confirm deletion
  </Step>
</Steps>

Before deleting:

* Download any data you need to keep
* Remove integrations you want to preserve
* Inform team members of the deletion

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invitation not received">
    Ask the recipient to check their spam folder. Verify the email address is correct. You can resend the invitation from the Members table.
  </Accordion>

  <Accordion title="Cannot change member role">
    Only Owners and Admins can change roles. Admins cannot change the Owner's role or promote others to Owner. Only the Owner can transfer ownership.
  </Accordion>

  <Accordion title="Cannot remove a member">
    Only Owners and Admins can remove members. You cannot remove the organization Owner - they must transfer ownership first.
  </Accordion>

  <Accordion title="Member count not updating after invite">
    The member count updates when the invitation is accepted, not when it's sent. Pending invitations don't count toward your member total.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Billing" icon="credit-card" href="/docs/settings/billing">
    Subscription and payments
  </Card>

  <Card title="Settings" icon="gear" href="/docs/settings/overview">
    Account configuration
  </Card>
</CardGroup>