---
title: "Count one call against a per-user feature quota"
method: POST
path: "/v1/auth/feature-quota/consume"
tags: ["Authentication"]
---

# Count one call against a per-user feature quota

`POST /v1/auth/feature-quota/consume`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/auth/feature-quota/consume`
- Auth: HTTP bearer

Atomic fixed-window counter for metered dashboard features (currently
`voice_brief`, 30 calls per hour). The limit and window are defined
server-side; the caller only names the feature. Users only.

## Request body

- object
  - `feature` 'voice_brief', required

## Response `200`

Whether this call is within the window's limit

- object
  - `allowed` boolean, required
  - `limit` integer, required
  - `remaining` integer, required
  - `reset_at` string, date-time, required

## Other responses

- `400`: Invalid request
- `403`: Insufficient permissions

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)