---
title: "Create Tier"
method: POST
path: "/admin/tiers"
tags: ["admin", "admin:tiers"]
---

# Create Tier

`POST /admin/tiers`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/admin/tiers`
- Auth: API key in cookie `fastapiusersauth`

Create a new tier.

## Request body

- TierCreate: Create tier request.
  - `display_name` string, required
  - `max_concurrent_workflows` integer, nullable
  - `max_action_executions_per_workflow` integer, nullable
  - `max_concurrent_actions` integer, nullable
  - `api_rate_limit` integer, nullable
  - `api_burst_capacity` integer, nullable
  - `entitlements` EntitlementsDict: TypedDict for tier entitlements stored in JSONB. All keys are optional (total=False) to support partial overrides.
    - `custom_registry` boolean: Whether custom registry repositories are enabled
    - `git_sync` boolean: Whether git sync is enabled
    - `agent_addons` boolean: Whether add-on agent capabilities are enabled (agent folders, tags, and case agent runs)
    - `case_addons` boolean: Whether add-on case capabilities are enabled (dropdowns, durations, tasks, triggers)
    - `rbac_addons` boolean: Whether RBAC add-ons are enabled (custom roles, groups, and assignments)
    - `service_accounts` boolean: Whether service accounts for API key access are enabled
    - `workspace_chat` boolean: Whether Workspace Chat is enabled
    - `multi_workspace` boolean: Whether multiple workspaces per organization are enabled
    - `watchtower` boolean: Whether Watchtower agent monitoring is enabled (agent sessions, tool-call telemetry, and controls)
    - `external_secret_stores` boolean: Whether workspace secrets may reference external secret stores such as AWS Secrets Manager
    - `agent_channels` boolean: Whether agent channels are enabled (agent approvals and interactions via Slack and Microsoft Teams)
    - `semantic_search` boolean: Whether semantic (vector) search over table columns is enabled
    - `forms` boolean: Whether workflow forms are enabled
    - `tunnels` boolean: Whether workspaces may route actions through private network tunnels such as Pangolin
    - `agent_runtime_preview` boolean: Whether agent backends other than the built-in one may be listed, used to create or fork agent sessions, and used to run new turns in existing sessions
  - `is_default` boolean
  - `sort_order` integer

## Response `201`

Successful Response

- TierRead: Tier response schema.
  - `id` string, uuid, required
  - `display_name` string, required
  - `max_concurrent_workflows` integer, nullable, required
  - `max_action_executions_per_workflow` integer, nullable, required
  - `max_concurrent_actions` integer, nullable, required
  - `api_rate_limit` integer, nullable, required
  - `api_burst_capacity` integer, nullable, required
  - `entitlements` EntitlementsDict, required: TypedDict for tier entitlements stored in JSONB. All keys are optional (total=False) to support partial overrides.
    - `custom_registry` boolean: Whether custom registry repositories are enabled
    - `git_sync` boolean: Whether git sync is enabled
    - `agent_addons` boolean: Whether add-on agent capabilities are enabled (agent folders, tags, and case agent runs)
    - `case_addons` boolean: Whether add-on case capabilities are enabled (dropdowns, durations, tasks, triggers)
    - `rbac_addons` boolean: Whether RBAC add-ons are enabled (custom roles, groups, and assignments)
    - `service_accounts` boolean: Whether service accounts for API key access are enabled
    - `workspace_chat` boolean: Whether Workspace Chat is enabled
    - `multi_workspace` boolean: Whether multiple workspaces per organization are enabled
    - `watchtower` boolean: Whether Watchtower agent monitoring is enabled (agent sessions, tool-call telemetry, and controls)
    - `external_secret_stores` boolean: Whether workspace secrets may reference external secret stores such as AWS Secrets Manager
    - `agent_channels` boolean: Whether agent channels are enabled (agent approvals and interactions via Slack and Microsoft Teams)
    - `semantic_search` boolean: Whether semantic (vector) search over table columns is enabled
    - `forms` boolean: Whether workflow forms are enabled
    - `tunnels` boolean: Whether workspaces may route actions through private network tunnels such as Pangolin
    - `agent_runtime_preview` boolean: Whether agent backends other than the built-in one may be listed, used to create or fork agent sessions, and used to run new turns in existing sessions
  - `is_default` boolean, required
  - `sort_order` integer, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)