---
title: "Update Approval Status on a Workflow"
method: PATCH
path: "/workflows/{id}/approvals/{roleId}"
tags: ["Workflows"]
---

# Update Approval Status on a Workflow

`PATCH /workflows/{id}/approvals/{roleId}`

Updates the status of an approval to the specified value. Approval statuses can only be updated during the Review step and when a given approval group is active (when it is that group's turn to approve). 

**OAuth Scope required:** `public.workflows.updateApprovals`

## Path parameters

- `id` string, required
- `roleId` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- object — Note that `user` is required when approving with a legacy bearer token but will be ignored when approving via an OAuth token. If the token was generated with the Authorization Code grant, the associated token user will be used. If the token was generated with the Client Credentials grant, the required `x-as-user-id` or 'x-as-user-email` header will be used.
  - `user` object — The Ironclad user approving the workflow. The user must be currently assigned as the approver.
    - `email` string — The Ironclad user's email address.
    - `type` string — The mechanism of identifying the Ironclad user's account.
  - `status` 'approved' | 'pending', required — The new approval status.

## Response `200`

200

- boolean

## Other responses

- `400` — 400

---

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