---
title: "Update an existing policy"
method: PATCH
path: "/v1/org/{orgId}/policy/{policyId}"
tags: ["policy"]
---

# Update an existing policy

`PATCH /v1/org/{orgId}/policy/{policyId}`

## Path parameters

- `orgId` string, required
- `policyId` string, required

## Request body

- UpdatePolicy
  - `label` string — human-readable full name of policy
  - `description` string — description of policy
  - `rules` PolicyRule[] — the rules that define the policy
    - `allow` string[] — allow rules
    - `deny` string[] — deny rules
    - `categories` string[] — categories the rule is limited to
    - `fields` string[] — fields the rule is limited to
    - `departmentIds` string[] — departments the rule is limited to
    - `filter` string — custom filter the rule is limited to
    - `directions` string[] — directions that the rule applies to -- either self or under
    - `types` string[] — types that the rule applies to
    - `targets` PolicyRuleTarget[] — targets allowed for messaging (email addresses, chat channels, user ids)
      - `userId` string
      - `personId` string
      - `channel` string
      - `email` string
    - `visibleSensitive` string[] — if specified, controls visibility of sensitive entities -- for example, ['Manager Shared', 'Manager Only']
    - `fieldsSensitive` string[] — if specified, controls applicability of fields by sensitivity -- for example, ['Manager Shared', 'Manager Only']

## Response `204`

policy updated

## Other responses

- `400` — invalid data
- `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/revisions/33fc84a173ce/schema)