Skip to main content

promote_aliases

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

Overview

Namepromote_aliases
TypeResource
Idvercel.projects.promote_aliases

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstring
aliasstring
statusstring

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectproject_idlimit, since, until, failed_only, team_id, slugGet a list of aliases related to the last promote request with their mapping status

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
project_idstring
failed_onlybooleanFilter results down to aliases that failed to map to the requested deployment (wire: failedOnly)
limitnumberMaximum number of aliases to list from a request (max 100).
sincenumberGet aliases created after this epoch 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 aliases created before this epoch timestamp.

SELECT examples

Get a list of aliases related to the last promote request with their mapping status

SELECT
id,
alias,
status
FROM vercel.projects.promote_aliases
WHERE project_id = '{{ project_id }}' -- required
AND limit = '{{ limit }}'
AND since = '{{ since }}'
AND until = '{{ until }}'
AND failed_only = '{{ failed_only }}'
AND team_id = '{{ team_id }}'
AND slug = '{{ slug }}'
;