---
title: "UpdateOrganization updates an organization"
method: PATCH
path: "/v1/orgs/{org}"
---

# UpdateOrganization updates an organization

`PATCH /v1/orgs/{org}`

## Path parameters

- `org` string, required

## Request body

- object
  - `billingEmail` string
  - `defaultProjectRole` string
  - `description` string
  - `displayName` string
  - `faviconAssetId` string
  - `logoAssetId` string
  - `logoDarkAssetId` string
  - `newName` string
  - `thumbnailAssetId` string

## Response `200`

A successful response.

- V1UpdateOrganizationResponse
  - `organization` V1Organization
    - `billingCustomerId` string
    - `billingEmail` string
    - `billingPlanDisplayName` string
    - `billingPlanName` string
    - `createdOn` string, date-time
    - `customDomain` string
    - `defaultProjectRoleId` string
    - `description` string
    - `displayName` string
    - `faviconUrl` string
    - `id` string
    - `logoDarkUrl` string
    - `logoUrl` string
    - `name` string
    - `paymentCustomerId` string
    - `quotas` V1OrganizationQuotas
      - `deployments` integer
      - `outstandingInvites` integer
      - `projects` integer
      - `seats` integer
      - `slotsPerDeployment` integer
      - `slotsTotal` integer
      - `storageLimitBytesPerDeployment` string, int64
    - `thumbnailUrl` string
    - `updatedOn` string, date-time

## Other responses

- `default` — An unexpected error response.

## Changes

> 54 revisions in range; 1 could not be searched.

- **2026-06-19** (v1) `af47beb69889` — 1 info
  - added the optional property `organization/quotas/seats` to the response with the `200` status
- **2025-12-12** (v1) `0928de6690f7` — 2 info
  - added the new optional request property `logoDarkAssetId`
  - added the optional property `organization/logoDarkUrl` to the response with the `200` status
- **2025-12-11** (v1) `f317ff96998d` — 3 warning
  - removed the request property `logoDarkAssetId`
  - removed the optional property `organization/logoDarkUrl` from the response with the `200` status
  - removed the optional property `organization/quotas/seats` from the response with the `200` status

[Change history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/patch.md)

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/abe7a430f373/schema)