---
title: "Update Organization"
method: PATCH
path: "/v1/orgs"
tags: ["Organizations"]
---

# Update Organization

`PATCH /v1/orgs`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/orgs`
- Auth: API key in header `Authorization`

Update the active organization's name and/or timezone.

## Headers

- `X-Organization-Id` string, uuid, nullable

## Request body

- OrganizationUpdate: Request body for updating the active organization. Both fields are optional; at least one must be present. ``timezone`` is an IANA name validated against the system timezone database.
  - `name` string, nullable
  - `timezone` string, nullable

## Response `200`

Successful Response

- OrganizationRead: Public view of an organization. ``plan`` is here so the dashboard can badge every membership in the org switcher without a per-org subscription call. It is the tier and nothing else — billing identifiers and subscription state stay on ``GET /v1/users/me/subscription``.
  - `id` string, uuid, required
  - `name` string, required
  - `timezone` string, required
  - `plan` 'FREE' | 'PLUS' | 'PRO' | 'MAX' | 'ENTERPRISE', required: Subscription tier of an organization; gates feature/usage limits.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)