Create access profile

Creates a new access profile template. The profile is inactive until attached to a role. No size limits are enforced on create; the limits apply on update.

POST /api/access-profiles

Error

A valid request URL is required to generate request examples

201

{
  "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.

Body

application/json

name · string · required

Maximum string length: 255

description · string

tags · string[]

provider_configs · object[]

Show child attributes

budgets · object[]

Show child attributes

rate_limit · object

Show child attributes

calendar_aligned · boolean

mcp_tool_groups · object[]

Show child attributes

mcp_servers · object[]

Show child attributes

mcp_tool_overrides · object[]

Show child attributes

Response

201

application/json

Profile created

access_profile · object

Show child attributes