---
title: "Update"
method: PATCH
path: "/organizations/{organizationId}"
tags: ["Organizations"]
---

# Update

`PATCH /organizations/{organizationId}`

## Path parameters

- `organizationId` string, required

## Request body

- OrganizationPartial
  - `aiFeatures` OrganizationAIFeatures — AI features that are enabled for the organization
    - `generateDetailedDescriptions` boolean — Whether to enable detailed descriptions for objects, connections, and diagrams
    - `generateDisplayDescriptions` boolean — Whether to enable display descriptions for objects
    - `generateDraftSummary` boolean — Whether to enable draft summaries for diagrams
    - `generateObjectSummary` boolean — Whether to enable object summaries for objects and connections in the right click context menu
  - `aiFeaturesEnabled` boolean — Whether to enable all AI features for the organization
  - `aiModel` 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano'
  - `billingCurrency` 'usd' | 'cad' | 'eur' | 'gbp'
  - `billingCycle` 'monthly' | 'annually'
  - `billingEmail` string, email
  - `experiments` object
  - `language` 'en-US' | 'en-GB' | 'fr-FR' | 'es-ES' | 'es-419'
  - `lineShapeDefault` 'curved' | 'straight' | 'square'
  - `name` string
  - `oauthLandscapeWriteEnabled` boolean — Whether OAuth connections can make changes to landscape data
  - `shareLinkAuthDomains` string[], nullable
  - `shareLinksEnabled` boolean

## Response `200`

OK

- object
  - `organization` Organization, required
    - `aiFeatures` OrganizationAIFeatures — AI features that are enabled for the organization
      - `generateDetailedDescriptions` boolean — Whether to enable detailed descriptions for objects, connections, and diagrams
      - `generateDisplayDescriptions` boolean — Whether to enable display descriptions for objects
      - `generateDraftSummary` boolean — Whether to enable draft summaries for diagrams
      - `generateObjectSummary` boolean — Whether to enable object summaries for objects and connections in the right click context menu
    - `aiFeaturesEnabled` boolean — Whether to enable all AI features for the organization
    - `aiModel` 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano'
    - `billingCurrency` 'usd' | 'cad' | 'eur' | 'gbp'
    - `billingCycle` 'monthly' | 'annually'
    - `billingEmail` string, email
    - `experiments` object
    - `language` 'en-US' | 'en-GB' | 'fr-FR' | 'es-ES' | 'es-419'
    - `lineShapeDefault` 'curved' | 'straight' | 'square', required
    - `name` string, required
    - `oauthLandscapeWriteEnabled` boolean, required — Whether OAuth connections can make changes to landscape data
    - `shareLinkAuthDomains` string[], nullable, required
    - `shareLinksEnabled` boolean, required
    - `autoInviteDomains` string[], required
    - `billingCollectionMethod` 'charge' | 'invoice'
    - `billingMonthlyCost` number
    - `billingPaymentMethod` boolean, required
    - `cancelAt` string, date-time
    - `canceledAt` string, date-time
    - `createdAt` string, date-time, required
    - `createdBy` 'user' | 'api-key' | 'notification-key' | 'service', required
    - `createdById` string, required
    - `id` string, required
    - `plan` 'free' | 'indie' | 'pilot' | 'growth' | 'scale' | 'isolation', required
    - `planEndsAt` string, date-time
    - `seats` number, required
    - `status` 'active' | 'canceled' | 'incomplete_expired' | 'incomplete' | 'past_due' | 'paused' | 'trialing' | 'unpaid', required
    - `trialEndsAt` string, date-time
    - `updatedAt` string, date-time, required
    - `updatedBy` 'user' | 'api-key' | 'notification-key' | 'service', required
    - `updatedById` string, required
    - `userIds` string[], required
    - `users` object, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Resource Exhausted
- `500` — Internal Server
- `503` — Service Unavailable

---

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