---
title: "Patch an organization"
method: PATCH
path: "/organizations/{organizationId}"
tags: ["Organizations"]
---

# Patch an organization

`PATCH /organizations/{organizationId}`

## Request

- Base URL: `https://api.xfa.tech`
- URL: `https://api.xfa.tech/organizations/{organizationId}`
- Auth: HTTP bearer

## Path parameters

- `organizationId` string, required

## Request body

- object: Partial update for an organization
  - `custom_message_onboarding` string, nullable: Custom message shown to end users on the webflow onboarding screen
  - `custom_message_sign_in` string, nullable: Custom message shown to end users on the webflow sign-in / enforcement screen
  - `self_invite_enabled` boolean, nullable: Allow verified native app users to request self-invite when eligible
  - `exclude_from_customer_metrics` boolean, nullable: Keeps this organization out of company-wide customer metrics. Only system administrators may change it. null clears it.
  - `manual_invite_send_slack` boolean: Last-used Slack toggle state in the manual Invite users popup.
  - `manual_invite_send_teams` boolean: Last-used Microsoft Teams toggle state in the manual Invite users popup.
  - `default_language` '' | 'en' | 'nl' | 'fr' | 'de' | 'es': Language for end-user emails when the recipient has not picked one; a user's own choice always wins. The set mirrors the email templates shipped by xfa-notification-service. An empty string is the canonical way to clear the organization default, on both PUT and PATCH, so the whole organization can be saved in one request; xfa-organizations-service stores it as an absent attribute.

## Response `204`

Organization patched

## Other responses

- `400`: The organization is not valid; the body is the reason as plain text (for example "Name of the organization cannot contain a phone number").
- `409`: The organization changed concurrently, or admin MFA approval is still enabled while its feature flag is being removed.

---

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