---
title: "Create Or Update Limits"
method: POST
path: "/management/limits"
tags: ["management"]
---

# Create Or Update Limits

`POST /management/limits`

Create user or upgrade their personal subscription.

## Headers

- `authorization` string, nullable

## Request body

- LimitsCreateRequest — Request model for POST /management/limits.
  - `id` string, required
  - `tier` string, nullable
  - `duration` integer, nullable
  - `reset_paid` boolean

## Response `200`

Successful Response

- LimitsCreateResponse — Response model for POST /management/limits.
  - `success` boolean, required
  - `action` string, required
  - `user` LimitsResponse — Response model for GET /management/limits.
    - `id` string, required
    - `blocked` boolean, required
    - `balance` number, required
    - `group_balances` object, required
    - `base_tier` string, required
    - `base_sub_start` string, date-time, required
    - `base_sub_end` string, date-time, required
    - `paid_tier` string, nullable, required
    - `paid_sub_start` string, date-time, nullable, required
    - `paid_sub_end` string, date-time, nullable, required
    - `active_subscription` string, required
    - `organization_id` string, nullable, required
    - `organization_member_id` string, nullable, required
    - `business_role` string, nullable, required
    - `business_tariff_id` string, nullable, required
    - `seat_id` string, nullable, required
    - `business_status` string, nullable, required
    - `business_email` string, nullable, required
    - `base_usage` ModelGroupUsageInfo[], required
      - `model_group` string, required
      - `current_calls` number, required
      - `max_calls` number, nullable, required
      - `period` string, nullable, required
      - `last_refresh` string, date-time, required
      - `next_refresh` string, date-time, nullable, required
    - `paid_usage` ModelGroupUsageInfo[], nullable, required
      - `model_group` string, required
      - `current_calls` number, required
      - `max_calls` number, nullable, required
      - `period` string, nullable, required
      - `last_refresh` string, date-time, required
      - `next_refresh` string, date-time, nullable, required
    - `business_usage` ModelGroupUsageInfo[], nullable, required
      - `model_group` string, required
      - `current_calls` number, required
      - `max_calls` number, nullable, required
      - `period` string, nullable, required
      - `last_refresh` string, date-time, required
      - `next_refresh` string, date-time, nullable, required
  - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kodacode/apis/xcode-proxy-gateway.md) · [All operations](https://skmtc.dev/kodacode/apis/xcode-proxy-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kodacode/xcode-proxy-gateway/revisions/7863886629fd/schema)