---
title: "Update org settings"
method: PATCH
path: "/orgs/current/settings"
tags: ["Organizations"]
---

# Update org settings

`PATCH /orgs/current/settings`

Update region preference and/or billing email opt-out for the current organization. Partial patch — omit fields to leave them unchanged. Pinning region 'auto' is rejected; choose a specific region first.

## Request body

- object
  - `billingEmailsEnabled` boolean
  - `defaultRegion` 'auto' | 'us-east-1' | 'eu-central-1'
  - `regionPinned` boolean

## Response `200`

Settings updated

- object
  - `data` object, required
    - `billingEmailsEnabled` boolean, required — Whether billing notification emails are enabled for this org
    - `defaultRegion` 'auto' | 'us-east-1' | 'eu-central-1', required — Preferred execution region, or 'auto' for platform default
    - `regionPinned` boolean, required — When true, jobs MUST run in defaultRegion (residency); no cross-region failover

## Other responses

- `400` — Validation error
- `401` — Unauthorized

## Changes

- **2026-08-31** `fafe355d0698` — 1 info
  - the security scope `orgs:write` was added to the endpoint's security scheme `bearerAuth`
- **2026-08-29** `4d10ec4266ee` — 1 info
  - api operation id `updateOrgSettings` was added

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/orgs/current/settings/patch.md)

---

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