---
title: "Reset Copilot Usage"
method: POST
path: "/api/chat/usage/reset"
tags: ["v2", "chat", "chat"]
---

# Reset Copilot Usage

`POST /api/chat/usage/reset`

Reset the daily CoPilot rate limit by spending credits.

Allows users who have hit their daily cost limit to spend credits
to reset their daily usage counter and continue working.
Returns 400 if the feature is disabled or the user is not over the limit.
Returns 402 if the user has insufficient credits.

## Response `200`

Successful Response

- RateLimitResetResponse — Response from resetting the daily rate limit.
  - `success` boolean, required
  - `credits_charged` integer, required — Credits charged (in cents)
  - `remaining_balance` integer, required — Credit balance after charge (in cents)
  - `usage` CoPilotUsagePublic, required — Current usage status for a user — public (client-safe) shape.
    - `daily` UsageWindowPublic — Public view of a usage window — only the percentage and reset time. Hides the raw spend and the cap so clients cannot derive per-turn cost or reverse-engineer platform margins. ``percent_used`` is capped at 100.
      - `percent_used` number, required — Percentage of the window's allowance used (0-100). Clamped at 100 when over the cap.
      - `resets_at` string, date-time, required
    - `weekly` UsageWindowPublic — Public view of a usage window — only the percentage and reset time. Hides the raw spend and the cap so clients cannot derive per-turn cost or reverse-engineer platform margins. ``percent_used`` is capped at 100.
      - `percent_used` number, required — Percentage of the window's allowance used (0-100). Clamped at 100 when over the cap.
      - `resets_at` string, date-time, required
    - `tier` 'NO_TIER' | 'BASIC' | 'PRO' | 'MAX' | 'BUSINESS' | 'ENTERPRISE' — 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
    - `reset_cost` integer — Credit cost (in cents) to reset the daily limit. 0 = feature disabled.

## Other responses

- `400` — Bad Request (feature disabled or daily limit not reached)
- `401` — Authentication required
- `402` — Payment Required (insufficient credits)
- `429` — Too Many Requests (max daily resets exceeded or reset in progress)
- `503` — Service Unavailable (Redis reset failed; credits refunded or support needed)

---

[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)