# Update Domain

POST /api/v2/projects/{projectId}/domains/{domainId}

Updates client-writable domain fields. Only the keys present in changes are written. Status, provider, DNS, verification, reputation, warmup, and the tracking subdomain are ignored even if sent. Do not use this to mark a domain verified or to turn sending on. Call Activate Email Sending, Activate Email Receiving, or Enable Shortlink, then Verify Email DNS, Verify Email Receiving DNS, or Verify Shortlink. DNS records are on Get Domain.

## Request

- projectId: string, path, required — ID of the project that owns the domain.
- domainId: string, path, required — ID of the domain to update.
- changes: object, required — Fields to change. Anything omitted is left as-is. Status, provider, DNS, verification, reputation, warmup, and the tracking subdomain are ignored even if sent. Use the activate, disable, and verify endpoints for those.
  - shortlinkEnabled: boolean

## Response

- 200: Successful response
  - createdAt: string, required
  - emailReceivingStatus: INACTIVE | PENDING | ACTIVE | ERROR, required, default INACTIVE
  - emailStatus: INACTIVE | PENDING | ACTIVE | ERROR, required, default INACTIVE
  - id: string, required
  - name: string, required
  - projectId: string, required
  - senderReputation: integer, required, default 50
  - shortlinkEnabled: boolean, required
  - trackingVerificationStatus: PENDING | VALID | INVALID, required, default PENDING
  - updatedAt: string, required
  - vercelConfigured: boolean, required
  - vercelVerificationStatus: PENDING | VALID | INVALID, required, default PENDING
  - warmupDay: integer, required, default 0
  - warmupSentCount: integer, required, default 0
  - warmupStatus: PENDING | WARMING | COMPLETED, required, default PENDING
  - emailProvider: string
  - emailProviderDomainId: string
  - emailReceivingProviderId: string
  - emailVerificationRequestedAt: string
  - receivingVerificationRequestedAt: string
  - senderReputationComputedAt: string
  - shortlinkVerificationRequestedAt: string
  - trackingSubdomain: string
  - vercelVerificationDNS: object[]
    - domain: string, required
    - type: string, required
    - value: string, required
    - reason: string
  - …
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 500: Internal server error
