---
title: "Hand the checking out as work, through the delegation machinery."
method: POST
path: "/actions/{id}/request-check"
---

# Hand the checking out as work, through the delegation machinery.

`POST /actions/{id}/request-check`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/actions/{id}/request-check`
- Auth: HTTP bearer

Creates a DELEGATION whose acceptance criterion is to report found, not_found_in_source or cannot_check for exactly this source and this period; both appear in expected_result. Delivering that delegation with a `check` object writes the delivery and the check in ONE transaction.

## Path parameters

- `id` string, required

## Request body

- object
  - `source` object
    - `kind` string
    - `detail` string
  - `period` object
    - `from` string, date-time
    - `to` string, date-time
  - `deadline_at` string, date-time
  - `requiredCapability` string, nullable

## Response `201`

Check delegated

- object
  - `ok` boolean
  - `delegation` object
  - `source` object
  - `period` object
  - `deliver_with` object

## Other responses

- `400`: CHECK_SCOPE_REQUIRED / DEADLINE_REQUIRED
- `404`: ACTION_NOT_FOUND
- `409`: ACTION_NOT_DELEGATABLE / DELEGATION_ALREADY_ACTIVE

---

[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)