---
title: "List approval workflows"
method: GET
path: "/approval-workflows"
tags: ["Approvals"]
---

# List approval workflows

`GET /approval-workflows`

## Request

- Base URL: `https://api.omnisocials.com/v1`
- URL: `https://api.omnisocials.com/v1/approval-workflows`
- Auth: HTTP bearer

Saved approval workflows the current workspace can use: company-wide workflows plus the ones bound to this workspace. Workflows are created and edited in the dashboard (Approvals); the API only lists them. Pass a workflow's `id` as `approval_workflow_id` on POST /posts/create to route a new scheduled post through it. The post is then created as `in_approval` and publishes at its `schedule_at` once the last step approves (dashboard, or POST /posts/{id}/approve). Requires the `posts:read` scope.

## Response `200`

Workflows available to this workspace (may be empty)

- object
  - `data` ApprovalWorkflow[]
    - `id` string: Pass this as `approval_workflow_id` on POST /posts/create
    - `name` string
    - `workspace_id` integer, nullable: Workspace the workflow is bound to, or null when it is available to every workspace of the company
    - `steps` ApprovalWorkflowStep[]
      - `order` integer: 1-based step order; steps are approved in order
      - `name` string
      - `require_mode` 'any' | 'all': `any` = one approver of this step is enough; `all` = every approver must approve
      - `approvers` ApprovalWorkflowApprover[]
        - `id` string, uuid: User id of the approver
        - `name` string, nullable
        - `email` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `403`: `insufficient_scope`: the key lacks posts:read

## Changes

- **2026-09-07** `bff746fd6191`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omnisocials/apis/omnisocials-api/changes/approval-workflows/get.md)

---

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