---
title: "List Workflow Approval Procedures"
method: GET
path: "/v2/workflows/{workflow_id}/approval-procedures"
tags: ["Workflow Approval Procedure API"]
---

# List Workflow Approval Procedures

`GET /v2/workflows/{workflow_id}/approval-procedures`

List all approval procedures for a workflow.

## Path parameters

- `workflow_id` string, required — The ID of the workflow to list approval procedures for.

## Response `200`

Success

- SvflowPublicapiListWorkflowApprovalProceduresResponse
  - `data` SvflowPubapimodelsWorkflowApprovalProcedure[] — The list of approval procedures (typically 0 or 1).
    - `id` string — The ID of the workflow approval procedure.
    - `workflowId` string — The ID of the workflow this approval procedure belongs to.
    - `steps` SvflowPubapimodelsApprovalStep[] — The steps in the approval procedure.
      - `id` string — The ID of the approval step.
      - `allowSelfApproval` boolean, nullable — Whether the step can be approved by the requester themselves. optional so server can distinguish "not set" from "explicitly false" (DB defaults to TRUE; proto3 defaults bool to false)
      - `approvers` SvflowPubapimodelsApprover[] — Exactly one of approvers or custom_workflow must be set. Mutual exclusivity validated server-side.
        - union — An approver source with notification preference.
          - object — App-instance owners as approvers. Only valid for access policy approval procedures.
            - `appOwner` SvflowPubapimodelsAppOwnerApprover, required — The owners of the app instance the requested role belongs to. Only valid for access policy approval procedures.
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — A Serval group as approvers.
            - `group` SvflowPubapimodelsGroupApprover, required — A Serval group as an approver.
              - …
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — The requester's manager as an approver.
            - `manager` SvflowPubapimodelsManagerApprover, required — The requester's manager as an approver.
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — Resource owners as approvers. Only valid for access policy approval procedures.
            - `resourceOwner` SvflowPubapimodelsResourceOwnerApprover, required — The owners of the resource the requested role belongs to. Only valid for access policy approval procedures.
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — Role (entitlement) owners as approvers. Only valid for access policy approval procedures.
            - `roleOwner` SvflowPubapimodelsRoleOwnerApprover, required — The owners of the requested role (entitlement) itself. Only valid for access policy approval procedures.
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — Team owners as approvers. Only valid for access policy approval procedures.
            - `teamOwner` SvflowPubapimodelsTeamOwnerApprover, required — The owners of the team that owns the requested role's app instance. Only valid for access policy approval procedures.
            - `notify` boolean — Whether to notify this approver when the step is pending.
          - object — A specific user as an approver.
            - `user` SvflowPubapimodelsUserApprover, required — A specific user as an approver.
              - …
            - `notify` boolean — Whether to notify this approver when the step is pending.
      - `customWorkflow` SvflowPubapimodelsCustomWorkflowConfig — Configuration for a custom workflow that determines approvers or auto-approves.
        - `workflowId` string — The ID of the workflow to execute.
      - `approverJustificationMode` string — Controls whether approvers are asked for a justification when deciding this step. Valid values: "not_requested", "optional", "required", "required_for_approval", "required_for_denial". Empty defaults to "not_requested". The "_for_approval" and "_for_denial" variants make the justification mandatory only when approving or denying, respectively.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)