> ## Documentation Index > Fetch the complete documentation index at: https://docs.ohmyho.st/llms.txt > Use this file to discover all available pages before exploring further. # Apply the server-derived project domains > Starts an idempotent durable operation for the exact project-derived development, production, and mail hostnames. The request has no body. ## OpenAPI ````yaml /openapi.json put /v1/projects/{project_id}/domains openapi: 3.1.2 info: title: ohmyho.st API version: 0.0.0 description: >- Public REST API for ohmyho.st hosting, projects, domains, email, credits and exports. servers: - url: https://app.ohmyho.st description: Production control API - url: https://dev.app.ohmyho.st description: Development control API security: - BearerAuth: [] paths: /v1/projects/{project_id}/domains: put: summary: Apply the server-derived project domains description: >- Starts an idempotent durable operation for the exact project-derived development, production, and mail hostnames. The request has no body. operationId: configureProjectDomains parameters: - $ref: '#/components/parameters/RequestId' - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/IdempotencyKey' responses: '202': $ref: '#/components/responses/AcceptedOperation' '400': $ref: '#/components/responses/Problem' '401': $ref: '#/components/responses/Problem' '403': $ref: '#/components/responses/Problem' '404': $ref: '#/components/responses/ResourceNotFound' '409': $ref: '#/components/responses/IdempotencyConflict' '429': $ref: '#/components/responses/Problem' '503': $ref: '#/components/responses/Problem' components: parameters: RequestId: name: X-Request-Id in: header description: Optional caller-provided correlation identifier. required: false schema: type: string minLength: 1 maxLength: 128 ProjectId: name: project_id in: path description: Project identifier. required: true schema: $ref: '#/components/schemas/Ulid' IdempotencyKey: name: Idempotency-Key in: header description: Identifies one mutation and its canonical request payload. required: true schema: type: string minLength: 1 maxLength: 128 responses: AcceptedOperation: description: The mutation was accepted for asynchronous processing. headers: Location: description: Relative URL of the durable operation resource. required: true schema: type: string pattern: ^/v1/operations/[0-9A-HJKMNP-TV-Z]{26}$ X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/Operation' Problem: description: The request failed. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' ResourceNotFound: description: >- The resource does not exist or is not visible to the authenticated principal. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' examples: resourceNotFound: value: type: https://docs.ohmyho.st/errors/resource-not-found title: Resource not found status: 404 code: resource_not_found request_id: req_01J00000000000000000000000 retryable: false suggested_action: Check the resource identifier and your access scope. IdempotencyConflict: description: The idempotency key was already used with a different canonical request. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/problem+json: schema: $ref: '#/components/schemas/IdempotencyConflictProblem' examples: reusedKey: value: type: https://docs.ohmyho.st/errors/idempotency-key-reused title: Idempotency key reused status: 409 code: idempotency_key_reused request_id: req_01J00000000000000000000000 retryable: false suggested_action: Retry with a new idempotency key. schemas: Ulid: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ Operation: type: object description: >- Durable record returned for an accepted asynchronous mutation. Optional reconciliation is a current observation for queued/running work, separate from immutable terminal state. A completed reconciliation attempt alone does not mean the operation succeeded. additionalProperties: false required: - id - state - created_at - updated_at properties: id: $ref: '#/components/schemas/Ulid' state: type: string enum: - queued - running - succeeded - failed - cancelled created_at: type: string format: date-time updated_at: type: string format: date-time result: type: object additionalProperties: true error: $ref: '#/components/schemas/OperationFailure' progress: $ref: '#/components/schemas/OperationDeploymentProgress' reconciliation: $ref: '#/components/schemas/OperationReconciliation' ProblemDetails: type: object description: RFC 9457 Problem Details extended with stable ohmyhost recovery fields. additionalProperties: false required: - type - title - status - code - request_id - retryable - suggested_action properties: type: type: string format: uri-reference title: type: string minLength: 1 status: type: integer minimum: 400 maximum: 599 detail: type: string instance: type: string format: uri-reference code: type: string enum: - invalid_request - unauthenticated - forbidden - resource_not_found - idempotency_key_reused - project_handle_unavailable - project_identity_unavailable - deployment_plan_expired - deployment_plan_incompatible - confirmation_expired - confirmation_invalid - etag_mismatch - promotion_source_stale - promotion_target_stale - promotion_invalid_target - mail_domain_conflict - mail_domain_required - framework_conversion_required - migration_filename_noncanonical - environment_secret_mutation_blocked - container_runtime_required - payload_too_large - rate_limited - insufficient_organization_credits - paid_plan_required - project_budget_exceeded - compute_performance_paid_required - compute_performance_unavailable - compute_change_pending - compute_change_conflict - billing_purchase_conflict - cloudflare_authorization_closed - project_notes_conflict - project_export_not_ready - interactive_login_required - api_key_creation_uncertain - api_key_permissions_unavailable - reconciliation_exhausted - service_unavailable request_id: type: string minLength: 1 maxLength: 128 retryable: type: boolean retry_after_seconds: type: integer minimum: 1 maximum: 86400 description: >- Optional machine-readable retry delay for a rate limit, matching Retry-After. suggested_action: type: string minLength: 1 IdempotencyConflictProblem: allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object properties: code: const: idempotency_key_reused OperationFailure: type: object additionalProperties: false required: - code - message - retryable - suggested_action properties: code: type: string enum: - operation_failed - recovery_dispatch_failed - recovery_job_failed - recovery_input_expired - recovery_database_unavailable - recovery_checksum_mismatch - recovery_scope_unavailable - recovery_archive_too_large - build_not_started - build_failed - database_compute_failed - database_compute_plan_changed - database_compute_rejected - database_migration_failed - insufficient_organization_credits - paid_plan_required - runtime_candidate_failed - container_runtime_secrets_unsupported - provider_state_absent message: type: string minLength: 1 maxLength: 512 retryable: type: boolean const: false description: >- A terminal operation cannot be retried in place; follow suggested_action. suggested_action: type: string minLength: 1 maxLength: 500 OperationDeploymentProgress: type: object additionalProperties: false description: >- Current deployment dependency observation, separate from immutable operation history. Poll the same operation; mail readiness does not mean application activation. required: - phase - project_id - deployment_id - observed_at - next_poll_after_seconds - suggested_action properties: build_completed_at: type: string format: date-time description: >- Actual successful CodeBuild completion time when this operation ran a build; omitted for reused artifacts without a current build. phase: type: string enum: - queued - building - publishing - waiting_for_mail - mail_status_unavailable project_id: $ref: '#/components/schemas/Ulid' deployment_id: $ref: '#/components/schemas/Ulid' observed_at: type: string format: date-time next_poll_after_seconds: type: integer const: 60 suggested_action: type: string minLength: 1 maxLength: 500 OperationReconciliation: type: object additionalProperties: false required: - state - attempt_id - observed_at - suggested_action properties: state: type: string enum: - required - pending attempt_id: oneOf: - $ref: '#/components/schemas/Ulid' - type: 'null' description: >- Active attempt for pending reconciliation; null when a new confirmed reconciliation is required. observed_at: type: string format: date-time suggested_action: type: string minLength: 1 maxLength: 500 headers: XRequestId: description: Correlates the request with operations, events, logs, and audit records. required: true schema: type: string minLength: 1 maxLength: 128 securitySchemes: BearerAuth: type: http scheme: bearer description: >- WorkOS access JWT or a user-owned WorkOS API key. User keys are bound to one organization and restricted to their enabled product permissions. Session-only onboarding and session revocation require an interactive access JWT. No cookie session is assumed. ````