---
title: "Update Organization"
method: PUT
path: "/admin/organizations/{organization_id}"
tags: ["organization-admin"]
---

# Update Organization

`PUT /admin/organizations/{organization_id}`

Update an organization.

Platform admin only. Updates organization via Temporal workflow.

## Path parameters

- `organization_id` string, required

## Request body

- UpdateOrganizationRequest — Request to update an organization.
  - `display_name` string, nullable — New display name
  - `config_name` string, nullable — New config name
  - `auth0_id` string, nullable — New Auth0 organization ID
  - `metadata` object, nullable — Metadata fields to update (merged with existing)
  - `email_domains` EmailDomainUpdateInput — Input for updating email domains.
    - `add` string[] — Domains to add
    - `remove` string[] — Domain IDs to remove
  - `auth_methods` AuthMethodUpdateInput — Input for updating auth methods.
    - `add` AuthMethodInput[] — Methods to add
      - `name` string, required — Friendly name for the auth method (e.g., 'Google')
      - `connection_id` string, required — Auth0 connection ID (e.g., 'google-oauth2', 'con_abc123')
    - `remove` string[] — Method IDs to remove
  - `is_invite_only` boolean, nullable — When true, new users can only join via an admin-issued invite link
  - `provision_auth0` boolean — Create a new Auth0 organization

## Response `200`

Successful Response

- UpdateOrganizationResponse — Response after updating an organization.
  - `organization` OrganizationDetail, required — Detailed organization information for admin views.
    - `id` string, required
    - `name` string, required
    - `display_name` string, nullable, required
    - `config_name` string, required
    - `auth0_id` string, nullable, required
    - `auth_provider` string, nullable, required
    - `org_identifier` string, nullable, required
    - `created_at` string, date-time, required
    - `archived_at` string, date-time, nullable, required
    - `is_invite_only` boolean
    - `email_domains` EmailDomain[], required
      - `id` string, required
      - `domain` string, required
      - `created_at` string, date-time, required
    - `auth_methods` AuthMethod[], required
      - `id` string, required
      - `name` string, required
      - `connection_id` string, required
      - `created_at` string, date-time, required
    - `metadata` object, nullable, required
  - `auth0_provisioned` boolean — Whether Auth0 organization was created

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)