Set individual users' AI credit limits

curl --request PATCH \
  --url https://{instance}.omniapp.co/api/v1/ai/credit-controls/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "users": [
    {
      "userId": "f4a2b3c8-0d1e-4f5a-9b6c-7d8e9f0a1b2c",
      "creditLimit": 50
    },
    {
      "userId": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f9a0b1c2d",
      "creditLimit": null
    }
  ]
}
'

{
  "users": [
    {
      "creditLimit": 50,
      "userId": "f4a2b3c8-0d1e-4f5a-9b6c-7d8e9f0a1b2c",
      "usesDefaultLimit": true
    }
  ]
}

{
  "detail": "Bad Request: prompt: Required",
  "status": 400
}

{
  "detail": "Unauthorized: Missing or invalid API key",
  "status": 401
}

{
  "detail": "Forbidden: AI query generation is not enabled for this organization",
  "status": 403
}

{
  "detail": "Model 770e8400-e29b-41d4-a716-446655440002 not found",
  "status": 404
}

{
  "error": "<response_code>",
  "message": "<error_reason>"
}

{
  "error": "<response_code>",
  "message": "<error_reason>"
}

PATCH

credit-controls

users

curl --request PATCH \
  --url https://{instance}.omniapp.co/api/v1/ai/credit-controls/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "users": [
    {
      "userId": "f4a2b3c8-0d1e-4f5a-9b6c-7d8e9f0a1b2c",
      "creditLimit": 50
    },
    {
      "userId": "a7b8c9d0-e1f2-3a4b-5c6d-7e8f9a0b1c2d",
      "creditLimit": null
    }
  ]
}
'

{
  "users": [
    {
      "creditLimit": 50,
      "userId": "f4a2b3c8-0d1e-4f5a-9b6c-7d8e9f0a1b2c",
      "usesDefaultLimit": true
    }
  ]
}

{
  "detail": "Bad Request: prompt: Required",
  "status": 400
}

{
  "detail": "Unauthorized: Missing or invalid API key",
  "status": 401
}

{
  "detail": "Forbidden: AI query generation is not enabled for this organization",
  "status": 403
}

{
  "detail": "Model 770e8400-e29b-41d4-a716-446655440002 not found",
  "status": 404
}

{
  "error": "<response_code>",
  "message": "<error_reason>"
}

{
  "error": "<response_code>",
  "message": "<error_reason>"
}

Authorizations

Authorization

string

header

required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Body

application/json

users

object[]

required

Users to update, at most 1000 per request. Each entry has a userId plus exactly one of creditLimit (number or null) or useDefaultLimit: true.

Required array length: 1 - 1000 elements

Show child attributes

Response

All entries applied. Returns each user's effective limit, in request order.

users

object[]

Show child attributes

List individual users' AI credit limits

List eval prompt sets

⌘I