Skip to main content

domain_project_domains

Creates, updates, deletes, gets or lists a domain_project_domains resource.

Overview​

Namedomain_project_domains
TypeResource
Idvercel.domains.domain_project_domains

Fields​

The following fields are returned by SELECT queries:

Successful response retrieving project domains for an apex domain.

NameDatatypeDescription
namestring
custom_environment_idstring (wire: customEnvironmentId)
project_idstring (wire: projectId)
apex_namestring (wire: apexName)
created_atnumber (wire: createdAt)
git_branchstring (wire: gitBranch)
redirectstring
redirect_status_codenumber (301, 302, 307, 308, ) (wire: redirectStatusCode)
updated_atnumber (wire: updatedAt)
verificationarrayA list of verification challenges, one of which must be completed to verify the domain for use on the project. After the challenge is complete POST /projects/:idOrName/domains/:domain/verify to verify the domain. Possible challenges: - If verification.type = TXT the verification.domain will be checked for a TXT record matching verification.value.
verifiedbooleantrue if the domain is verified for use with the project. If false it will not be used as an alias on this project until the challenge in verification is completed. (false, true)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectdomainlimit, since, until, team_id, slugList all project domains associated with an apex domain owned by the authenticated account.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
domainstringThe apex domain name.
limitnumberMaximum number of project domains to list from a request.
sincenumberGet project domains created after this JavaScript timestamp.
slugstringThe Team slug to perform the request on behalf of.
team_idstringThe Team identifier to perform the request on behalf of. (wire: teamId)
untilnumberGet project domains created before this JavaScript timestamp.

SELECT examples​

List all project domains associated with an apex domain owned by the authenticated account.

SELECT
name,
custom_environment_id,
project_id,
apex_name,
created_at,
git_branch,
redirect,
redirect_status_code,
updated_at,
verification,
verified
FROM vercel.domains.domain_project_domains
WHERE domain = '{{ domain }}' -- required
AND limit = '{{ limit }}'
AND since = '{{ since }}'
AND until = '{{ until }}'
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;