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

# Update Organization

`PUT /admin/organizations/{organization_id}`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/admin/organizations/{organization_id}`
- Auth: none declared

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.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)