# Update a policy

> PATCH /policies/{id} endpoint of the Proteside API: parameters, request body, responses and code samples.

URL: https://docs.proteside.com/en/docs/api/reference/policies/updatePolicy

## Method and route

`PATCH /policies/{id}`

Changing `match`, `conditions`, `action`, `justification_template` or `expires_days` increments `version`.

## Parameters

- `id` (path, `string`, required)
- `org_id` (query, `string`): Partners only (`orgs:manage`): act on this child organization. May also be sent as `org_id` in JSON bodies.

## Request body

- `name` (`string`)
- `description` (`string,null`)
- `mode` (`"recommend" | "auto"`)
- `priority` (`integer`)
- `match` (`object`)
- `conditions` (`object`)
- `action` (`"authorize" | "needs_review" | "block"`)
- `justification_template` (`string,null`)
- `expires_days` (`integer,null`)
- `active` (`boolean`)

## Responses

- `200`: Policy
- `404`: Not found in the acting organization

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
