---
title: "Set User Rate Limit Tier"
method: POST
path: "/api/copilot/admin/rate_limit/tier"
tags: ["v2", "admin", "copilot", "admin"]
---

# Set User Rate Limit Tier

`POST /api/copilot/admin/rate_limit/tier`

Set a user's rate-limit tier. Admin-only.

Returns 404 if the user does not exist in the database.

## Request body

- SetUserTierRequest
  - `user_id` string, required
  - `tier` 'NO_TIER' | 'BASIC' | 'PRO' | 'MAX' | 'BUSINESS' | 'ENTERPRISE', required — Subscription tiers with increasing cost allowances. Mirrors the ``SubscriptionTier`` enum in ``schema.prisma``. Once ``prisma generate`` is run, this can be replaced with:: from prisma.enums import SubscriptionTier

## Response `200`

Successful Response

- UserTierResponse
  - `user_id` string, required
  - `tier` 'NO_TIER' | 'BASIC' | 'PRO' | 'MAX' | 'BUSINESS' | 'ENTERPRISE', required — Subscription tiers with increasing cost allowances. Mirrors the ``SubscriptionTier`` enum in ``schema.prisma``. Once ``prisma generate`` is run, this can be replaced with:: from prisma.enums import SubscriptionTier

## Other responses

- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)