---
title: "BudgetMyAttention — manage finite review capacity"
method: POST
path: "/v1/attention-budgets/manage"
---

# BudgetMyAttention — manage finite review capacity

`POST /v1/attention-budgets/manage`

## Request

- Base URL: `https://api.scrubmytext.com`
- URL: `https://api.scrubmytext.com/v1/attention-budgets/manage`
- Auth: HTTP bearer

Creates, checks, reserves, releases, or closes a review-capacity pool with per-subject limits and protected priority capacity.

## Request body

- object
  - `operation` 'create' | 'reserve' | 'check' | 'release' | 'close', required
  - `control_id` string
  - `total_units` integer
  - `max_units_per_subject` integer
  - `protected_priority_units` integer
  - `period_seconds` integer
  - `reservation_key` string
  - `subject_fingerprint` string: A lowercase SHA-256 digest, with an optional sha256: prefix.
  - `units` integer
  - `priority` 'standard' | 'priority'

## Response `200`

Capacity state or reservation decision

## Other responses

- `401`: Paid API key required
- `422`: Invalid operation-specific input

---

[API](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api.md) · [All operations](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrubmytext/apis/scrubmytext-agent-infrastructure-api/revisions/54ace36baccf?raw)