ServerlessV1Build

Create a new Build resource. At least one function version or asset version is required.

Changed on

Create a new Build resource. At least one function version or asset version is required.

post/v1/Services/{ServiceSid}/Builds

Request

  • Base URL
    https://serverless.twilio.com
  • URL
    https://serverless.twilio.com/v1/Services/{ServiceSid}/Builds
  • Auth
    HTTP basic

Path parameters

ServiceSidstring required

The SID of the Service to create the Build resource under.

Request body application/x-www-form-urlencoded

AssetVersionsstring[]

The list of Asset Version resource SIDs to include in the Build.

FunctionVersionsstring[]

The list of the Function Version resource SIDs to include in the Build.

Dependenciesstring

A list of objects that describe the Dependencies included in the Build. Each object contains the name and version of the dependency.

Runtimestring

The Runtime version that will be used to run the Build resource when it is deployed.

Response

Created

sidstring nullable

The unique string that we created to identify the Build resource.

account_sidstring nullable

The SID of the Account that created the Build resource.

service_sidstring nullable

The SID of the Service that the Build resource is associated with.

status'building' | 'completed' | 'failed'

The status of the Build. Can be: building, completed, or failed.

runtime'node8' | 'node10' | 'node12' | 'node14' | 'node16' | 'node18' | 'node20' | 'node22' | 'node24'

The Runtime version that will be used to run the Build resource when it is deployed.

date_createdstring date-time nullable

The date and time in GMT when the Build resource was created specified in ISO 8601 format.

date_updatedstring date-time nullable

The date and time in GMT when the Build resource was last updated specified in ISO 8601 format.

urlstring uri nullable

The absolute URL of the Build resource.

linksobject nullable

Changes

  • v174f59534eb42Revision changes
    • warning

      added the new node24 enum value to the response property for the response status

  • v1ab2588f4f607Revision changes
    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      the / response's property type changed from object to no type for status