builds

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

Overview

Name	builds
Type	Resource
Id	vercel.deployments.builds

Fields

The following fields are returned by SELECT queries:

get_builds_for_deployment

An object representing a Build on Vercel

Name	Datatype	Description
id	string	The unique identifier of the Build
config	object	An object that contains the Build's configuration
copiedFrom	string
createdAt	number	The time at which the Build was created
createdIn	string	The region where the Build was first created
deployedAt	number	The time at which the Build was deployed
deploymentId	string	The unique identifier of the deployment
entrypoint	string	The entrypoint of the deployment
fingerprint	string	If the Build uses the @vercel/static Runtime, it contains a hashed string of all outputs
output	array	A list of outputs for the Build that can be either Serverless Functions or static files
readyState	string	The state of the deployment depending on the process of deploying, or if it is ready or in an error state
readyStateAt	number	The time at which the Build state was last modified
scheduledAt	number	The time at which the Build was scheduled to be built
use	string	The Runtime the Build used to generate the output

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_builds_for_deployment	select	deploymentId		Retrieves the list of builds given their deployment's unique identifier. No longer listed as public API as of May 2023.
_get_builds_for_deployment	exec	deploymentId		Retrieves the list of builds given their deployment's unique identifier. No longer listed as public API as of May 2023.

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.

Name	Datatype	Description
deploymentId	string	The deployment unique identifier

SELECT examples

get_builds_for_deployment

Retrieves the list of builds given their deployment's unique identifier. No longer listed as public API as of May 2023.

SELECT
id,
config,
copiedFrom,
createdAt,
createdIn,
deployedAt,
deploymentId,
entrypoint,
fingerprint,
output,
readyState,
readyStateAt,
scheduledAt,
use
FROM vercel.deployments.builds
WHERE deploymentId = '{{ deploymentId }}' -- required
;

Lifecycle Methods

_get_builds_for_deployment

Retrieves the list of builds given their deployment's unique identifier. No longer listed as public API as of May 2023.

EXEC vercel.deployments.builds._get_builds_for_deployment 
@deploymentId='{{ deploymentId }}' --required
;