---
title: "Update Organization"
method: PUT
path: "/api/organizations/{id}"
tags: ["Organization"]
---

# Update Organization

`PUT /api/organizations/{id}`

Updates an organization's name and SSO or OIDC configuration.

> 🚧 Requires partner key
>
> This endpoint is only accessible using [partner keys](../../../guides/obtaining-api-keys#partner-keys).

> 📘 SSO and OIDC configuration is replaced in full on each update. Include all
> desired settings in the request body, not just the fields you want to change.

## Path parameters

- `id` string, uuid, required — Unique identifier of the organization to update.

## Headers

- `X-Polytomic-Version` string

## Request body

- UpdateOrganizationRequestSchema
  - `client_id` string — OIDC client ID issued by the identity provider.
  - `client_secret` string — OIDC client secret issued by the identity provider. Write-only; never returned in responses.
  - `issuer` string — OIDC issuer URL for organizations using OpenID Connect single sign-on.
  - `name` string, required — Human-readable name of the organization. Must be unique across the partner account.
  - `sso_domain` string — Email domain used to match users to this organization during SSO sign-in.
  - `sso_org_id` string — WorkOS organization identifier linking this organization to its SAML/SSO configuration.

## Response `200`

OK

- OrganizationEnvelope
  - `data` Organization
    - `id` string, uuid — Unique identifier of the organization.
    - `issuer` string — OIDC issuer URL for organizations using OpenID Connect single sign-on.
    - `name` string — Human-readable name of the organization.
    - `sso_domain` string — Email domain used to match users to this organization during SSO sign-in.
    - `sso_org_id` string — WorkOS organization identifier linking this organization to its SAML/SSO configuration.

## Other responses

- `403` — Forbidden
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)