Skip to main content

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.

​
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

Modifying LLM settings requires Admin or Owner permissions.
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

Adding credits requires Admin or Owner permissions.
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

Claiming Git organizations requires Owner permissions.
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.
You must have admin access to the Git organization to claim it. The verification process confirms your authorization.

​
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