Organizations

What are Organizations?

Organizations are the top-level entity in LLM Gateway. They contain:

Projects: Logical groupings of API keys and configurations
Team Members: Users with different permission levels
Billing: Credits, subscriptions, and payment methods
Provider Keys: Shared API keys for upstream providers
Usage Analytics: Aggregated usage across all projects

You can belong to multiple organizations and switch between them in the dashboard.

Creating an Organization

Via Dashboard

Open Organization Menu

Click your current organization name in the top navigation.

Create New Organization

Select Create Organization from the dropdown.

Enter Details

Provide a name for your organization (e.g., “Acme Corp”, “Personal Projects”).

Configure Billing

Your billing email is pre-filled. Update if needed.

A Default Project is automatically created in new organizations.

Via API

Create an organization programmatically:

curl -X POST https://api.llmgateway.io/api/v1/organizations \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp"
  }'

Response:

{
  "organization": {
    "id": "org_123abc",
    "name": "Acme Corp",
    "billingEmail": "[email protected]",
    "credits": "0",
    "plan": "free",
    "retentionLevel": "none",
    "status": "active",
    "isPersonal": false,
    "createdAt": "2024-03-15T10:00:00Z"
  }
}

Free plan users can create up to 3 organizations. Contact support to increase this limit.

Organization Settings

Basic Information

Update your organization details:

curl -X PATCH https://api.llmgateway.io/api/v1/organizations/org_123abc \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "billingEmail": "[email protected]",
    "billingCompany": "Acme Corp Ltd",
    "billingAddress": "123 Main St, San Francisco, CA 94105",
    "billingTaxId": "US123456789"
  }'

Data Retention

Control how long request logs are stored:

curl -X PATCH https://api.llmgateway.io/api/v1/organizations/org_123abc \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "retentionLevel": "retain"
  }'

Retention Levels:

Level	Free Plan	Pro Plan	Enterprise
`none`	3 days	3 days	90 days
`retain`	3 days	90 days	Custom

Extended retention requires a Pro or Enterprise plan. Upgrade in your organization settings.

Auto Top-Up

Automatically recharge credits when balance falls below a threshold:

curl -X PATCH https://api.llmgateway.io/api/v1/organizations/org_123abc \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "autoTopUpEnabled": true,
    "autoTopUpThreshold": 10,
    "autoTopUpAmount": 50
  }'

This configuration will:

Trigger when credits fall below $10
Automatically charge $50 to your payment method
Continue service without interruption

Team Management

Collaborate with team members by inviting them to your organization.

User Roles

Owner
Admin
Developer

Full control over the organization:

Manage team members
Access all projects
Manage billing and subscriptions
Configure provider keys
Delete organization

Inviting Team Members

Navigate to Team Settings

Go to Organization Settings → Team.

Send Invitation

Click Invite Member and enter:

Email address
Role (Owner, Admin, or Developer)

Await Acceptance

The user will receive an email invitation. They must accept to join.

Managing Members

Update a team member’s role:

curl -X PATCH https://api.llmgateway.io/api/v1/team/member_789xyz \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

Remove a team member:

curl -X DELETE https://api.llmgateway.io/api/v1/team/member_789xyz \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Only owners can modify other owners’ roles or remove them from the organization.

Billing & Credits

Credit System

LLM Gateway uses a credit system for simplified billing:

$1 = 1 credit
Credits are deducted based on token usage
Unused credits never expire
Refunds return credits to your balance

Purchasing Credits

Dashboard
API

Navigate to Billing in organization settings
Click Add Credits
Enter amount (minimum $10)
Complete payment with card or other method

curl -X POST https://api.llmgateway.io/api/v1/payments/credit-topup \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "organizationId": "org_123abc",
    "amount": 50
  }'

Transaction History

View all transactions for your organization:

curl https://api.llmgateway.io/api/v1/organizations/org_123abc/transactions \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Response:

{
  "transactions": [
    {
      "id": "txn_abc123",
      "type": "credit_topup",
      "amount": "50.00",
      "creditAmount": "50.00",
      "currency": "USD",
      "status": "completed",
      "description": "Credit top-up",
      "createdAt": "2024-03-15T10:00:00Z"
    },
    {
      "id": "txn_def456",
      "type": "subscription_start",
      "amount": "29.00",
      "currency": "USD",
      "status": "completed",
      "description": "Pro Plan - Monthly",
      "createdAt": "2024-03-01T00:00:00Z"
    }
  ]
}

Payment Methods

Add or update payment methods in Organization Settings → Billing → Payment Methods. Supported payment methods:

Credit/debit cards (Visa, Mastercard, Amex)
ACH bank transfers (US only)
SEPA direct debit (Europe)

Subscription Plans

Free
Pro
Enterprise

$0/month

3-day log retention
Up to 3 organizations
Up to 10 projects per org
Community support
Pay-as-you-go credits

Upgrading Your Plan

Upgrade to Pro via the dashboard:

Go to Organization Settings → Billing
Click Upgrade to Pro
Choose billing frequency (monthly/yearly)
Complete payment setup

For Enterprise, contact our sales team.

Provider Keys

Configure organization-wide provider API keys to use your own accounts with the gateway.

Supported Providers

OpenAI
Anthropic (Claude)
Google (Gemini, Vertex AI)
AWS Bedrock
Azure OpenAI
Alibaba Cloud (Qwen)
Custom OpenAI-compatible endpoints

Adding Provider Keys

Navigate to Provider Keys

Go to Organization Settings → Provider Keys.

Add New Key

Click Add Provider Key and select your provider.

Enter Credentials

Paste your API key and configure any provider-specific options.

Test Connection

Click Test to verify the key works correctly.

For detailed provider setup, see the Provider Keys Guide.

When provider keys are configured, requests in hybrid or api-keys mode will use your keys directly, with no gateway markup.

Usage Analytics

Monitor organization-wide usage across all projects:

curl https://api.llmgateway.io/api/v1/organizations/org_123abc/usage \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -G \
  -d "startDate=2024-03-01" \
  -d "endDate=2024-03-31"

Metrics include:

Total requests
Token usage by model
Cost breakdown
Error rates
Cache hit rates
Provider distribution

Deleting an Organization

Permanently delete an organization:

curl -X DELETE https://api.llmgateway.io/api/v1/organizations/org_123abc \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

This action is irreversible and will:

Delete all projects and API keys
Remove all team members
Delete all logs and analytics
Forfeit remaining credits (no refund)

Personal organizations (from dev plans) cannot be deleted this way. Cancel your dev plan at code.llmgateway.io instead.

Only organization owners can delete organizations.

Best Practices

Organization Structure

Create separate orgs for different businesses/clients
Use one organization per team for large companies
Keep personal projects in a separate organization
Name organizations clearly for easy identification

Team Management

Review team member access quarterly
Use the Developer role for most team members
Limit Admin and Owner roles to trusted individuals
Remove access immediately when members leave
Document who has access to what

Billing

Enable auto top-up to prevent service interruptions
Set appropriate threshold and amount
Review transactions monthly
Consider yearly subscription for savings
Set up budget alerts

Security

Enable 2FA for all owner accounts
Use provider keys instead of credits when possible
Regularly rotate provider API keys
Monitor usage for anomalies
Keep billing email up to date

Next Steps

Projects

Create and manage projects within your organization.

Team Management

Invite team members and manage permissions.

Provider Keys

Configure your own provider API keys.

Analytics

Track usage and optimize costs.

Get Started

Core Features

Guides

Integrations

What are Organizations?

Creating an Organization

Via Dashboard

Via API

Organization Settings

Basic Information

Data Retention

Auto Top-Up

Team Management

User Roles

Inviting Team Members

Managing Members

Billing & Credits

Credit System

Purchasing Credits

Transaction History

Payment Methods

Subscription Plans

Upgrading Your Plan

Provider Keys

Supported Providers

Adding Provider Keys

Usage Analytics

Deleting an Organization

Best Practices

Next Steps

Projects

Team Management

Provider Keys

Analytics

Build docs developers (and LLMs) love

Get Started

Core Features

Guides

Integrations

​What are Organizations?

​Creating an Organization

​Via Dashboard

​Via API

​Organization Settings

​Basic Information

​Data Retention

​Auto Top-Up

​Team Management

​User Roles

​Inviting Team Members

​Managing Members

​Billing & Credits

​Credit System

​Purchasing Credits

​Transaction History

​Payment Methods

​Subscription Plans

​Upgrading Your Plan

​Provider Keys

​Supported Providers

​Adding Provider Keys

​Usage Analytics

​Deleting an Organization

​Best Practices

​Next Steps

Projects

Team Management

Provider Keys

Analytics

Build docs developers (and LLMs) love

What are Organizations?

Creating an Organization

Via Dashboard

Via API

Organization Settings

Basic Information

Data Retention

Auto Top-Up

Team Management

User Roles

Inviting Team Members

Managing Members

Billing & Credits

Credit System

Purchasing Credits

Transaction History

Payment Methods

Subscription Plans

Upgrading Your Plan

Provider Keys

Supported Providers

Adding Provider Keys

Usage Analytics

Deleting an Organization

Best Practices

Next Steps