---
title: "Update policy backend settings"
method: PATCH
path: "/v1/org/settings/policy-backend"
tags: ["Organization"]
---

# Update policy backend settings

`PATCH /v1/org/settings/policy-backend`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/org/settings/policy-backend`
- Auth: HTTP bearer

Configure backend (builtin, cedar, opa, builtin+cedar, builtin+opa), mode (shadow/enforce),
scope actions, and circuit breaker behavior. Owner/admin only.

## Request body

- UpdatePolicyBackendSettingsRequest
  - `backend` 'builtin' | 'cedar' | 'opa' | 'builtin+cedar' | 'builtin+opa'
  - `mode` 'shadow' | 'enforce'
  - `scope` string[]
  - `breaker_behavior` 'fail_closed' | 'fail_open_builtin'

## Response `200`

Updated settings

- PolicyBackendSettingsResponse
  - `backend` 'builtin' | 'cedar' | 'opa' | 'builtin+cedar' | 'builtin+opa'
  - `mode` 'shadow' | 'enforce'
  - `scope` string[]
  - `breaker_behavior` 'fail_closed' | 'fail_open_builtin'
  - `policy_version` integer

## Other responses

- `400`: Invalid request
- `401`: Authentication required or invalid
- `403`: Insufficient permissions

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)