Skip to content
KoboiLLM Docs

Team Management API

If you manage a Team on KoboiLLM, you receive a Team Management Key (Team Admin API Key). This key authorizes programmatic administration over your team’s resources — enabling real-time budget tracking, transaction logging, member invites, and automated Virtual Key generation directly from your internal applications.

Primary Integration Parameters

  • Management Base URL: https://api.koboillm.com
  • Authorization Header: Supply your Management Key as a Bearer token: 
    Authorization: Bearer ***
  • Team ID: Available on your team account dashboard (e.g., team_99c03b...).

1. Fetching Team Balance & Budget Info

Use this endpoint to query maximum team budget limits, spend balances, and token usage summaries.

  • Method & Route: GET /team/info
  • Query Parameters:
    • team_id (string, required): Your unique team identifier.

cURL Example:

Terminal window
curl -X GET "https://api.koboillm.com/team/info?team_id=your-team-id" \
     -H "Authorization: Bearer *** \
     -H "accept: application/json"

JSON Response:

{
  "team_info": {
    "team_id": "team_99c03b41-f761-463d-8ab1-16b0b471ec1b",
    "team_alias": "Retail Socks Co",
    "spend": 15.4306,
    "max_budget": 100.00,
    "budget_duration": "30d",
    "budget_reset_at": "2026-08-01T00:00:00Z"
  },
  "keys": [
    {
      "key_name": "Editor Key 1",
      "key_alias": "editor_key",
      "spend": 12.0450,
      "max_budget": 50.00,
      "models": ["openai/gpt-4o-mini", "anthropic/claude-3-5-sonnet"]
    }
  ]
}

2. Programmatic Key Generation (/key/generate)

Dynamically issue new virtual API keys with custom budget caps and model permissions for end users or microservices.

  • Method & Route: POST /key/generate
  • Request Body (JSON): 
    {
      "team_id": "team_99c03b41-f761-463d-8ab1-16b0b471ec1b",
      "key_alias": "sub_user_key_01",
      "max_budget": 10.0,
      "models": ["openai/gpt-4o-mini"]
    }

cURL Example:

Terminal window
curl -X POST "https://api.koboillm.com/key/generate" \
     -H "Authorization: Bearer *** \
     -H "Content-Type: application/json" \
     -d '{
       "team_id": "your-team-id",
       "key_alias": "client_alpha_key",
       "max_budget": 5.0,
       "models": ["openai/gpt-4o-mini"]
     }'

3. Revoking or Deleting Virtual Keys (/key/delete)

  • Method & Route: POST /key/delete
  • Request Body (JSON): 
    {
      "keys": ["sk-key-token-hash-to-delete"]
    }