---
title: "Update Organization"
method: PATCH
path: "/api/platform/organizations/{org_id}"
tags: ["platform"]
---

# Update Organization

`PATCH /api/platform/organizations/{org_id}`

## Request

- Base URL: `https://app.gocrisp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.gocrisp.com/api/platform/organizations/{org_id}`
- Auth: OAuth 2
  - Authorization code: `https://login.gocrisp.com/authorize`
  - Token URL: `https://login.gocrisp.com/oauth/token`

Replace local allowed email domains (members-organizations editor required).

This field constrains future membership and member-role additions through
the shared Auth0 writer. Existing memberships and FGA grants are unchanged.

## Path parameters

- `org_id` string, required

## Request body

- UpdateOrganizationRequest: Edit only Dock metadata, without mutating Auth0 identity or membership.
  - `emailDomains` string[], required
  - `emailDomainsUnconstrained` boolean

## Response `200`

Successful Response

- Organization: A single organization in the connected Auth0 tenant.
  - `id` string, required
  - `name` string, required
  - `displayName` string, nullable
  - `emailDomains` string[]
  - `emailDomainsUnconstrained` boolean
  - `emailDomainsReadOnly` boolean
  - `brandingLogoUrl` string, nullable
  - `brandingColorsPrimary` string, nullable
  - `memberCount` integer
  - `groups` OrganizationGroup[]
    - `id` string, required
    - `displayName` string, nullable
    - `readonly` boolean
    - `deletionProtected` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `ab52a750f38c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gocrisp/apis/crisp-app-dock/changes/api/platform/organizations/:org_id/patch.md)

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) - [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) - [OpenAPI document](https://skmtc.dev/gocrisp/apis/crisp-app-dock/revisions/28638f87e7d4?raw)