---
title: "Update an organization (org_admin; tier, status and kind are super_admin only)"
method: PATCH
path: "/api/orgs/{orgId}"
tags: ["orgs"]
---

# Update an organization (org_admin; tier, status and kind are super_admin only)

`PATCH /api/orgs/{orgId}`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- PatchOrgBody
  - `name` string
  - `lang` 'he' | 'en' | 'pt'
  - `tier` 'standard' | 'dedicated' | 'byoc'
  - `status` 'active' | 'suspended' | 'archived'
  - `kind` 'customer' | 'internal' | 'demo' | 'system' | 'test' | 'personal'
  - `branding` object
    - `brand` string
    - `logoUrl` string
  - `emailDomains` string[]

## Response `200`

Updated.

- object
  - `id` string, required
  - `slug` string, required
  - `name` string, required
  - `tier` 'standard' | 'dedicated' | 'byoc'
  - `status` 'active' | 'suspended' | 'archived'
  - `kind` 'customer' | 'internal' | 'demo' | 'system' | 'test' | 'personal'
  - `lang` 'he' | 'en' | 'pt'
  - `region` 'europe-west1'
  - `branding` object
    - `brand` string
    - `logoUrl` string, uri
  - `data` object
    - `projectId` string
    - `datasetId` string
    - `runtimeIdentity` string
    - `filesBucket` string
    - `stagingBucket` string
  - `plan` object
    - `id` string, required
    - `quotas` object
  - `retention` object
    - `conversationDays` integer
  - `timezone` string
  - `greetingExamples` string[]
  - `createdAt` string, date-time, required
  - `createdBy` string
  - `updatedAt` string, date-time
  - `updatedBy` string
  - `schemaVersion` integer
  - `emailDomains` string[]
  - `security` object
    - `mfa` 'admins' | 'all'
    - `mfaTrustIdp` boolean
    - `signIn` object
      - `methods` string[]
      - `open` boolean
      - `byRole` object
        - `admin` object
          - `methods` string[]
          - `mfa` object
            - `required` boolean
        - `member` object
          - `methods` string[]
          - `mfa` object
            - `required` boolean
    - `externalAgentWrite` boolean
    - `lockedBy` 'platform'
  - `aiDisclosure` object
    - `enabled` boolean
    - `text` object
      - `he` string
      - `en` string
      - `pt` string
    - `notifyExisting` boolean

## Other responses

- `403`: Insufficient role.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)