---
title: "Update Organization Configuration"
method: PUT
path: "/v4/organizations/{organizationId}/configuration"
tags: ["Organizations"]
---

# Update Organization Configuration

`PUT /v4/organizations/{organizationId}/configuration`

Updates an existing organization configuration. Use this endpoint to add, update, and delete network subdomains.

Subdomains are not automatically available. You must contact Couchbase support to enable this feature. To open a Support ticket, see [Create a Support Ticket](https://docs.couchbase.com/cloud/support/manage-support.html#create-support-ticket).

Subdomains:
- Can have a maximum of 30 alphanumeric characters.
- Must be a unique string and not already in use in another tenant or organization. Empty strings are allowed.
- Only affect new clusters. You cannot update existing clusters to include a new subdomain.

In order to access this endpoint, the provided API key must have the following role:
- Organization Owner

To learn more, see [Organization, Project, and Database Access Overview](https://docs.couchbase.com/cloud/organizations/organization-projects-overview.html).

## Headers

- `If-Match` string

## Request body

- UpdateOrganizationConfigurationRequest
  - `subdomain` string, required — The new name of the subdomain for the organization.

## Response `204`

Successfully updated the organization configuration.

## Other responses

- `403` — The client does not have the necessary permissions to access this resource.
- `404` — The requested resource was not found.
- `412` — Returned when there is a mismatch with the Etag version.
- `422` — Request validation error.
- `429` — Returned when the client exceeds the rate limit for the given APIKey.
- `500` — An unexpected error occurred in the server while processing this request.

---

[API](https://skmtc.net/couchbase/apis/couchbase-capella-management-api.md) · [All operations](https://skmtc.net/couchbase/apis/couchbase-capella-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/couchbase/couchbase-capella-management-api/revisions/e67df5d1f74e/schema)