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

# Organization Settings

> Configure shared resources and settings for your OpenHands organization.

## Overview

Organization settings allow Admins and Owners to configure shared resources that all members can use. This
includes LLM configurations, credits management, and Git organization claims.

## LLM Configuration

<Note>
  Modifying LLM settings requires Admin or Owner permissions.
</Note>

Organizations can define a default LLM provider and model that all members will use:

1. Hover over the profile icon in the lower left — an account menu will appear.
2. Select **Organization**.
3. Select the `LLM` tab.
4. Select the `LLM` tab.
5. Choose your preferred **LLM provider** from the available options.
6. Select the **model** you want to use as the default.
7. Click `Save Changes`.

All organization members will use this LLM configuration for their conversations unless they have configured
personal overrides.

## Managing Credits

<Note>
  Adding credits requires Admin or Owner permissions.
</Note>

Organization credits are shared across all members. To add credits:

1. Hover over the profile icon in the lower left — an account menu will appear.
2. Select **Organization**.
3. Click **+ Add**.
4. Choose the amount of credits to purchase.
5. Complete the payment process.

Credits will be added to the organization's shared pool immediately and can be used by any member.

### Monitoring Usage

You can monitor credit usage from the **Organization** settings page, which shows the current credit balance.

For detailed usage reporting at the user level, use the API endpoint:

```
GET /api/organizations/{org_id}/members/financial
```

This endpoint provides financial usage data for all members within your organization.

## Claiming Git Organizations

<Note>
  Claiming Git organizations requires Owner permissions.
</Note>

Claiming a Git organization links it to your OpenHands organization, allowing OpenHands resolver requests
for repositories in that Git organization to be routed to your organization.

Owners have the ability to claim a Git organization:

1. Hover over the profile icon in the lower left — an account menu will appear.
2. Select **Organization**.
3. In the **Git Conversation Routing** section, Git organizations from your linked GitHub/GitLab accounts are listed automatically.
4. Click **Claim** next to the Git organization you want to link to your OpenHands organization.

<Warning>
  You must have admin access to the Git organization to claim it. The verification process confirms your
  authorization.
</Warning>

### Benefits of Claiming Git Organizations

When a Git organization is claimed:

* All resolver requests for repositories in that Git organization are automatically routed to your OpenHands organization.
* Organization members can work seamlessly with repositories in the claimed Git organization.
* Usage is tracked against your organization's credit pool.

## Next Steps

* [Managing Members](/openhands/usage/cloud/organizations/managing-members) - Invite users and manage roles.
* [Roles and Permissions](/openhands/usage/cloud/organizations/roles-permissions) - Understand permission levels.