---
title: "Configure domain management settings"
method: PUT
path: "/api/{org_id}/domain_management"
tags: ["Domain Management"]
---

# Configure domain management settings

`PUT /api/{org_id}/domain_management`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/domain_management`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/domain_management/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the domain management configuration for custom domain settings, SSL certificates, and DNS routing. Only accessible by the meta organization for security and administrative control. Allows configuration of custom domains, certificate management, and traffic routing for enterprise deployments with custom branding and domain requirements.

## Path parameters

- `org_id` string, required

## Request body

- object: Request body for creating/updating domain management configuration
  - `blocked_domains` string[]: Whole domains to block (external SSO identities only).
  - `blocked_emails` string[]: Exact emails to block from all access (external SSO identities only). Block wins over allow.
  - `domains` DomainConfigRequest[], required: List of domain configurations
    - `allow_all_users` boolean: Whether all users from this domain are allowed MUTUALLY EXCLUSIVE with allowed_emails - when true, allowed_emails must be empty
    - `allowed_emails` string[]: List of specific email addresses allowed from this domain MUTUALLY EXCLUSIVE with allow_all_users - when not empty, allow_all_users must be false
    - `domain` string, required: Domain name (e.g., "example.com")
    - `enabled` boolean: Whether this domain configuration is active
  - `enabled` boolean: Whether domain restrictions are enabled

## Response `200`

Success

- DomainOperationResponse: Response for a single domain operation
  - `domain` string, nullable: The domain that was operated on
  - `message` string, required: Success message

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)