---
title: "Ask for one approval covering several calls"
method: POST
path: "/approvals"
tags: ["approval"]
---

# Ask for one approval covering several calls

`POST /approvals`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/approvals`
- Auth: HTTP bearer

Bundles up to 50 calls to outward or legal actions into one approval, so the person approves them in one sitting. Returns approval_required; send the person to approval_url, then call approval_get.

## Request body

- object
  - `calls` object[], required
    - `action` string, required
    - `input` union, required
      - string
      - number
      - boolean
      - EnvelopeEventsOutSchema0[]
        - union
          - string
          - number
          - boolean
          - EnvelopeEventsOutSchema0[]
          - object
      - object
  - `summary` string

## Response `200`

The result.

- object
  - `status` 'approval_required', required
  - `approval_id` string, required
  - `approval_url` string, required
  - `expires_at` string, date-time, required
  - `payload_hash` string, required
  - `summary` string, required
  - `items` object[], required
    - `id` string, required
    - `action` string, required
    - `summary` string, required

## Other responses

- `default`: An RFC 9457 problem.

---

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