Skip to main content
PUT
/
api
/
access-profiles
/
{id}
Error
A valid request URL is required to generate request examples
{
  "access_profile": {
    "id": 123,
    "name": "<string>",
    "description": "<string>",
    "is_active": true,
    "version": 123,
    "tags": [
      "<string>"
    ],
    "provider_configs": [
      {
        "provider_name": "<string>",
        "id": 123,
        "all_models_allowed": true,
        "allowed_models": [
          "<string>"
        ],
        "budgets": [
          {
            "max_limit": 123,
            "id": "<string>",
            "scope": "<string>",
            "current_usage": 123,
            "last_reset": "2023-11-07T05:31:56Z"
          }
        ],
        "rate_limit": {
          "id": "<string>",
          "token_max_limit": 123,
          "request_max_limit": 123,
          "token_current_usage": 123,
          "request_current_usage": 123
        }
      }
    ],
    "budgets": [
      {
        "max_limit": 123,
        "id": "<string>",
        "scope": "<string>",
        "current_usage": 123,
        "last_reset": "2023-11-07T05:31:56Z"
      }
    ],
    "rate_limit": {
      "id": "<string>",
      "token_max_limit": 123,
      "request_max_limit": 123,
      "token_current_usage": 123,
      "request_current_usage": 123
    },
    "calendar_aligned": true,
    "mcp_tool_groups": [
      {
        "tool_group_id": 123
      }
    ],
    "mcp_servers": [
      {
        "mcp_server_id": "<string>"
      }
    ],
    "mcp_tool_overrides": [
      {
        "mcp_client_id": "<string>",
        "tool_name": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

​
id
integer
required

Body

application/json

Partial update. Omitted fields preserve the current value. rate_limit: null explicitly clears the existing rate limit; omitting the field preserves it. Update enforces size limits not enforced on create: max 100 provider_configs, max 100 budgets, max 50 tags.

​
name
string
Maximum string length: 255
​
description
string | null
​
tags
string[]
​
provider_configs
object[]
​
budgets
object[]
​
rate_limit
object
​
calendar_aligned
boolean | null
​
mcp_tool_groups
object[]
​
mcp_servers
object[]
​
mcp_tool_overrides
object[]

Response

Profile updated

​
access_profile
object