Reserve scarce human-review capacity without letting retries or one agent consume it all.
Create a period pool, cap each subject, protect priority capacity, and use a stable reservation key for every retried request.
Step 1 · Create the pool
curl https://api.scrubmytext.com/v1/attention-budgets/manage -H "Authorization: Bearer smt_live_YOUR_KEY" -H "Content-Type: application/json" -d '{"operation":"create","total_units":100,"max_units_per_subject":10,"protected_priority_units":20,"period_seconds":86400}'Step 2 · Reserve idempotently
curl https://api.scrubmytext.com/v1/attention-budgets/manage -H "Authorization: Bearer smt_live_YOUR_KEY" -H "Content-Type: application/json" -d '{"operation":"reserve","control_id":"att_RETURNED_ID","reservation_key":"review-ticket-482","subject_fingerprint":"sha256:YOUR_64_HEX_DIGEST","units":2,"priority":"standard"}'Queue human review only when reserved: true. Retry with the same key and identical values; block or defer on any other result.
Step 3 · Release unused capacity
Use release with the same pool ID and reservation key when work is canceled before review. Use close to stop new reservations.
Limits
- Units are caller-defined and do not prove a reviewer exists.
- Protected capacity prevents standard work from consuming the reserve; it does not schedule people or assess review quality.
- Hash stable subjects consistently so the per-subject cap is meaningful.