---
title: "Update organization by ID"
method: PUT
path: "/v1/organizations/{organizationId}"
tags: ["Organizations"]
---

# Update organization by ID

`PUT /v1/organizations/{organizationId}`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/organizations/{organizationId}`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

Update organization properties including name, description, logo, authentication type, email domain, and feature settings. Requires organization or system admin privileges.

## Parameters

- `#/paths/~1v1~1organizations~1{organizationId}/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `orgSlug` Schema, required (unresolved $ref)
  - `name` Schema, required (unresolved $ref)
  - `emailDomain` string, required
  - `authType` AuthType (unresolved $ref)
  - `description` string
  - `logo` string
  - `features` object
    - `ssoGroupMapping` object
      - `admin` Admin (unresolved $ref)
      - `member` Admin (unresolved $ref)
      - `readonly` Admin (unresolved $ref)
    - `auditTrail` object
      - `enabled` boolean
      - `changeReasonEnabled` boolean
    - `continuousVerification` object
      - `enabled` boolean
  - `tenantId` Id (unresolved $ref)

## Response `200`

Responding with Organization details

- Schema (unresolved $ref)

## Other responses

- `401`: Invalid token
- `403`: Caller is not authorized to perform this action
- `404`: Organization not found.

---

[API](https://skmtc.dev/tetrascience/apis/administration.md) - [All operations](https://skmtc.dev/tetrascience/apis/administration/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/administration/revisions/c1c829febcc5?raw)
