---
title: "Ask a human to confirm a fact, decide a choice, or permit one exact operation."
method: POST
path: "/attention-requests"
---

# Ask a human to confirm a fact, decide a choice, or permit one exact operation.

`POST /attention-requests`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/attention-requests`
- Auth: HTTP bearer

Requires capability attention:request. FORBIZ decides whether this deserves an interruption: the response says interrupted true or false, and a queued ask goes out on a later tick. A fact already answered within 90 days returns already_answered without interrupting anyone. Knowing a budget is not permission to spend it: an authorization names one exact operation and one exact scope, lives at most 24 hours, is single-use, and overrides no gate.

## Request body

- object
  - `kind` 'fact' | 'choice' | 'authorization'
  - `about` object
  - `blocked` object
  - `statement` string
  - `options` object[]
  - `permission` object
  - `deadline_at` string, date-time

## Response `200`

ALREADY_ANSWERED or DUPLICATE_PENDING — no human was interrupted

- object
  - `status` string
  - `interrupted` boolean
  - `request` object

## Other responses

- `201`: Stored. `status` is pending (delivered) or queued (budget or precedence deferred it).
- `400`: INVALID_KIND / JUSTIFICATION_REQUIRED / INVALID_ABOUT / EVIDENCE_NOT_FOUND / STATEMENT_REQUIRED / OPTIONS_REQUIRED / PERMISSION_REQUIRED, with expected
- `404`: OBJECT_NOT_FOUND — nothing was stored
- `409`: NO_REACHABLE_HUMAN — nothing was stored

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)