Get Usage Configuration

Retrieve per-user add-on credit cap configuration, queried by team, group, or individual user scope for enterprise billing management.

POST /api/v1/GetUsageConfig

Get Usage Configuration

cURL

curl --request POST \
  --url https://server.codeium.com/api/v1/GetUsageConfig \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "team_level": true,
  "group_id": "<string>",
  "user_email": "<string>"
}
'

200

{
  "addOnCreditCap": 123
}

Overview

Retrieve the current per-user add-on credit cap configuration for your organization. Caps are always per-user. When you query by team or group scope, the response returns the per-user cap that has been applied to users within that team or group.

Request

service_key · string · required

Your service key with “Billing Read” permissions

Scope Configuration (Choose One)

team_level · boolean

Set to true to retrieve the per-user cap applied to all users on the team

group_id · string

Retrieve the per-user cap applied to all users in a specific group by providing the group ID

user_email · string

Retrieve the configuration for a specific user by providing their email address

You must provide one of team_level, group_id, or user_email to define the scope.

Example Request - Get Per-User Cap for All Users on Team

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "team_level": true
}' \
https://server.codeium.com/api/v1/GetUsageConfig

Example Request - Get Per-User Cap for All Users in a Group

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig

Example Request - Get User Configuration

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "user_email": "[e-mail]"
}' \
https://server.codeium.com/api/v1/GetUsageConfig

Response

addOnCreditCap · integer

The configured add-on credit cap value. If this field is not present in the response, there is no cap configured at the requested scope level.

Example Response - With Cap Configured

{
  "addOnCreditCap": 10000
}

Example Response - No Cap Configured

{}

Error Responses

Common error scenarios:

• Invalid service key or insufficient permissions
• Multiple scope parameters provided
• No scope parameter provided
• Invalid group ID or user email
• Rate limit exceeded