POST /v10/projects/{idOrName}/domains
Add a domain to the project by passing its domain name and by specifying the project by either passing the project id
or name
in the URL. If the domain is not yet verified to be used on this project, the request will return verified = false
, and the domain will need to be verified according to the verification
challenge via POST /projects/:idOrName/domains/:domain/verify
. If the domain already exists on the project, the request will fail with a 400
status code.
Servers
- https://api.vercel.com
Path parameters
Name | Type | Required | Description |
---|---|---|---|
idOrName |
String | Yes |
The unique project identifier or the project name |
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
teamId |
String | No |
The Team identifier to perform the request on behalf of. |
slug |
String | No |
The Team slug to perform the request on behalf of. |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
redirectStatusCode |
Integer | No |
Status code for domain redirect Possible values:
|
name |
String | Yes |
The project domain name |
gitBranch |
String | No |
Git branch to link the project domain |
customEnvironmentId |
String | No |
The unique custom environment identifier within the project |
redirect |
String | No |
Target destination domain for redirect |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.