---
title: "Hand this action's work to another agent, with the acceptance criterion written first."
method: POST
path: "/actions/{id}/delegations"
---

# Hand this action's work to another agent, with the acceptance criterion written first.

`POST /actions/{id}/delegations`

## Request

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

`acceptance_criterion` and `expected_result` are REQUIRED and are stored before anyone executes, so the judgement cannot be invented afterwards. `deadline_at` must be in the future. Only an action that is still pending and not yet executed can be delegated, and only one delegation can be active per action; the delegation changes NONE of the action's four status columns. `required_capability`, when given, only filters who may take it.

## Path parameters

- `id` string, required

## Request body

- object
  - `acceptance_criterion` string
  - `expected_result` string
  - `deadline_at` string, date-time
  - `required_capability` string, nullable

## Response `200`

Delegation opened

- object
  - `ok` boolean
  - `delegation` object

## Other responses

- `400`: CRITERION_REQUIRED / DEADLINE_REQUIRED, with expected
- `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)