---
title: "Create a new approval request"
method: POST
path: "/api/approval-requests"
tags: ["ApprovalRequests"]
---

# Create a new approval request

`POST /api/approval-requests`

## Request body

- object
  - `title` string, required
  - `questions` object[], required
    - `id` string, required
    - `type` 'approval' | 'text' | 'single-select' | 'multi-select' | 'boolean', required
    - `label` string, required
    - `required` boolean
    - `description` string
    - `placeholder` string
    - `multiline` boolean
    - `options` object[]
      - `value` string, required
      - `label` string, required
      - `description` string
    - `minSelections` integer
    - `maxSelections` integer
    - `defaultValue` boolean
  - `approvers` object, required
    - `users` string[]
    - `roles` string[]
    - `policy` union, required
      - 'any'
      - 'all'
      - object
        - `min` integer, required
  - `workflowRunId` string, uuid
  - `workflowRunStepId` string, uuid
  - `sourceTaskId` string, uuid
  - `timeoutSeconds` integer
  - `notifications` object[]
    - `channel` 'slack' | 'email', required
    - `target` string, required

## Response `201`

Approval request created

## Other responses

- `400` — Validation error

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/4f62e32be8ec?raw)