---
title: "Update or move apex domain"
method: PATCH
path: "/v3/domains/{domain}"
tags: ["domains"]
---

# Update or move apex domain

`PATCH /v3/domains/{domain}`

Update or move apex domain. Note: This endpoint is no longer used for updating auto-renew or nameservers. For this, please use the endpoints [Update auto-renew for a domain](https://vercel.com/docs/rest-api/reference/endpoints/domains-registrar/update-auto-renew-for-a-domain) and [Update nameservers for a domain](https://vercel.com/docs/rest-api/reference/endpoints/domains-registrar/update-nameservers-for-a-domain).

## Path parameters

- `domain` string, required

## Query parameters

- `teamId` string
- `slug` string

## Request body

- union
  - object — update
    - `op` string
    - `renew` boolean — This field is deprecated. Please use PATCH /v1/registrar/domains/{domainName}/auto-renew instead.
    - `customNameservers` string[] — This field is deprecated. Please use PATCH /v1/registrar/domains/{domainName}/nameservers instead.
    - `zone` boolean — Specifies whether this is a DNS zone that intends to use Vercel's nameservers.
  - object — move-out
    - `op` string
    - `destination` string — User or team to move domain to

## Response `200`

- union
  - object
    - `moved` false | true, required
  - object
    - `moved` false | true, required
    - `token` string, required
  - object
    - `renew` false | true
    - `customNameservers` string[]
    - `zone` false | true

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `409`
- `410`
- `500`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/b4d86a3e3479/schema)