---
title: "Update a approval chain"
method: PATCH
path: "/v1/org/{orgId}/approval-chain/{approvalChainId}"
tags: ["approval"]
---

# Update a approval chain

`PATCH /v1/org/{orgId}/approval-chain/{approvalChainId}`

## Path parameters

- `orgId` string, required
- `approvalChainId` string, required

## Request body

- UpdateApprovalChain
  - `name` string — human-readable name of approval chain
  - `isPreview` boolean — isPreview specifies that this is a preview for implementations that use it (e.g. Compensation Reviews)
  - `fallbackApproverJobId` string — the jobId of the fallback approver
  - `fallbackApproverJobError` string — most recent error for fallback approver
  - `approvalNotifierGroups` ApprovalNotifierGroup[] — notifier groups with optional conditions for post-approval notification
    - `groupId` string, required — globally unique id for this notifier group
    - `userIds` string[], required — user ids to notify in this group
    - `inclusionBehavior` 'ONLY_INCLUDE_IF' | 'EXCLUDE_IF' — condition behavior for this notifier group; null means always notify
    - `inclusionExpression` string — expression to evaluate for conditional notification

## Response `202`

snapshot currently building

## Other responses

- `400` — bad request
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

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