---
title: "List approval workflows"
method: GET
path: "/api/v1/workspaces/{workspace_id}/approval-workflows"
tags: ["✅ Approval Workflows"]
---

# List approval workflows

`GET /api/v1/workspaces/{workspace_id}/approval-workflows`

Retrieve the workspace's published (non-draft) multi-level approval workflows. Use the returned `id` as `approval.workflow_id` when creating or updating a post.

## Path parameters

- `workspace_id` string, required

## Response `200`

Approval workflows retrieved successfully

- object
  - `status` boolean
  - `message` string
  - `data` object[]
    - `id` string
    - `_id` string — Deprecated alias for `id` — will be removed once clients migrate.
    - `name` string
    - `is_default` boolean
    - `levels` object[]
      - `level_number` integer
      - `title` string, nullable
      - `rule` 'anyone' | 'everyone'
      - `members` object[]
        - `user_id` string

## Other responses

- `401` — Unauthorized - Invalid API key
- `403` — Forbidden - No access to workspace
- `429` — Too many requests

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) · [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contentstudio/contentstudio-api-v1/revisions/ec0c85521883/schema)