---
title: "Use one reset chance"
method: POST
path: "/resets/use"
tags: ["Billing"]
---

# Use one reset chance

`POST /resets/use`

## Request

- Base URL: `https://console-api.blockvectra.com/v1`
- URL: `https://console-api.blockvectra.com/v1/resets/use`
- Auth: HTTP bearer

Use the earliest expiring chance to replenish balance up to reset_to_units. No request body. Returns 409 no_reset_available when no chances remain, or reason nothing_to_reset when balance is already at or above the target; in either case no chance is consumed. A disabled account returns 403 user_disabled.

## Response `200`

Reset completed.

- ResetUseResponse
  - `refill_units` integer, required: Amount credited in this reset (difference between target and pre-reset balance).
  - `balance_units` integer, required: Balance after credit (settled balance, matching `GET /balance`).
  - `remaining` integer, required: Sum of remaining chances across all rounds after use.

## Other responses

- `401`: Missing or invalid session (without distinguishing cause).
- `403`: Account disabled.
- `409`: No reset chance available, or balance not below target.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

[API](https://skmtc.dev/blockvectra/apis/blockvectra-console-api.md) · [All operations](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockvectra/apis/blockvectra-console-api/revisions/28c91298f433?raw)