---
title: "Create approval requests"
method: POST
path: "/approvals"
tags: ["Approvals"]
---

# Create approval requests

`POST /approvals`

Create one or more approval requests for a post

## Request body

- CreateApprovalsInput
  - `postId` string, uuid, required
  - `approvals` object[], required
    - `userId` string, uuid, required
    - `message` string
    - `dueDate` string, date-time
    - `isBlocking` boolean

## Response `200`

Approvals created

- object
  - `createdApprovals` Approval[]
    - `id` string, uuid
    - `status` 'Requested' | 'Approved'
    - `isBlocking` boolean
    - `message` string, nullable
    - `dueDate` string, date-time, nullable
    - `approvedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `user` ApprovalUser
      - `id` string, uuid
      - `email` string, email
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `createdAt` string, date-time
    - `requestedBy` ApprovalUser
      - `id` string, uuid
      - `email` string, email
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `createdAt` string, date-time
  - `existingApprovals` Approval[]
    - `id` string, uuid
    - `status` 'Requested' | 'Approved'
    - `isBlocking` boolean
    - `message` string, nullable
    - `dueDate` string, date-time, nullable
    - `approvedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `user` ApprovalUser
      - `id` string, uuid
      - `email` string, email
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `createdAt` string, date-time
    - `requestedBy` ApprovalUser
      - `id` string, uuid
      - `email` string, email
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `createdAt` string, date-time

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/versions/1d0792ff454f/schema)