---
title: "SudoUpdateOrganizationCustomDomain updates the custom domain for an organization.
It only updates the custom domain in the database, which is used to ensure correct redirects.
The DNS records and ingress TLS must be configured separately."
method: PATCH
path: "/v1/superuser/organization/custom-domain"
---

# SudoUpdateOrganizationCustomDomain updates the custom domain for an organization.
It only updates the custom domain in the database, which is used to ensure correct redirects.
The DNS records and ingress TLS must be configured separately.

`PATCH /v1/superuser/organization/custom-domain`

## Request body

- V1SudoUpdateOrganizationCustomDomainRequest
  - `customDomain` string
  - `name` string

## Response `200`

A successful response.

- V1SudoUpdateOrganizationCustomDomainResponse
  - `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

- **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` — 1 info
  - added the optional property `organization/logoDarkUrl` to the response with the `200` status
- **2025-12-11** (v1) `f317ff96998d` — 2 warning
  - 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/superuser/organization/custom-domain/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)