Reset limits with a promotion right

POST /v1/cowork/limits/reset

Spends one right to reset Cowork/Code limits: the usage of all three quota windows on the user's seat — the 5-hour, weekly and monthly windows — is reset to zero. The window boundaries, the date of the next charge and any temporary limit increase stay unchanged.

A right is granted under a platform promotion and stays valid until that promotion ends. The user and the account come from the key binding; there are no path parameters. The operation is irreversible: a spent right cannot be restored.

Request fields (body)

Examples

The endpoint supports only one authorization method: a Cowork/Code desktop key. A personal key and an application key receive 403 INSUFFICIENT_SCOPE or 403 COWORK_DESKTOP_KEY_REQUIRED.

curl — Cowork/Code desktop key

curl -X POST https://vibecode.bitrix24.com/v1/cowork/limits/reset \
  -H "X-Api-Key: YOUR_COWORK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rightId": "cmg2k8x1f0003qz0l7a9b4c2d"}'

JavaScript — Cowork/Code desktop key

const res = await fetch('https://vibecode.bitrix24.com/v1/cowork/limits/reset', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_COWORK_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ rightId: 'cmg2k8x1f0003qz0l7a9b4c2d' }),
})

if (!res.ok) {
  const { error } = await res.json()
  // 404 and 409 — re-read the subscription summary and show what it returns.
  console.error(error.code)
} else {
  const { data } = await res.json()
  // alreadyUsed: true — show the regular success screen: the right was spent earlier.
  console.log(`Limits reset: ${data.usedAt}`)
}

Response fields

Response example

{
  "success": true,
  "data": {
    "rightId": "cmg2k8x1f0003qz0l7a9b4c2d",
    "usedAt": "2026-10-02T09:15:42.118Z",
    "alreadyUsed": false
  }
}

Error response example

409 — the right's promotion has ended or the right was revoked:

{
  "success": false,
  "error": {
    "code": "COWORK_LIMIT_RESET_RIGHT_EXPIRED",
    "message": "The limit-reset right is no longer available: its promotion has ended or the right was revoked."
  }
}

Errors

The full list of common API errors — Errors.

Known specifics

rightId is the idempotency key, so retry a network failure with the same value. A repeat call after a successful spend returns 200 with alreadyUsed: true and the moment of the first spend — show the regular success screen. Retry a network failure or a 5xx response, except 503 COWORK_FEATURE_DISABLED, up to three times with the same rightId and a random delay. Do not retry 400, 401 or 403.

After 404 or 409, re-read the subscription summary. The right may have expired or been revoked between polls, or the seat may have stopped being active. The summary shows what is left and the next right, if there is one.

The response does not include quota percentages. After a successful reset, re-read the full state and the subscription summary: the usage of the three windows is already zero, and the exhaustion flag is cleared.

The limitReset block may be absent. It arrives in the summary and the full state only when limit reset with a promotion right is enabled for the account. No block means no capability: do not show the button.

Only a desktop key can spend a right. An agent seat key sees the rights block but cannot spend a right: a reset is a one-off action by a person in front of the screen.

A right is bound to the user in the account, not to the tier. Changing the tier and pausing or resuming the subscription do not affect the right, but it can be spent only on an active seat.

See also

• Cowork/Code subscription summary
• Cowork/Code subscription state
• Tier change preview
• Cowork/Code
• Errors