Create a new Build resource

POST /v1/Services/{ServiceSid}/Builds

A collection of Function Versions, Asset Versions, Dependencies, and a Runtime that form a deployable unit.

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

Path parameters

  • ServiceSid string Required

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

Body

  • AssetVersions array[string]

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

    Minimum length of each is 34, maximum length of each is 34. Format of each should match the following pattern: ^ZN[0-9a-fA-F]{32}$.

  • Dependencies string

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

  • FunctionVersions array[string]

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

    Minimum length of each is 34, maximum length of each is 34. Format of each should match the following pattern: ^ZN[0-9a-fA-F]{32}$.

  • Runtime string

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

Responses

  • 201

    Created

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the Build resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • asset_versions array | null

      The list of Asset Version resource SIDs that are included in the Build

    • date_created string(date-time) | null

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

    • date_updated string(date-time) | null

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

    • dependencies array | null

      A list of objects that describe the Dependencies included in the Build

    • function_versions array | null

      The list of Function Version resource SIDs that are included in the Build

    • links object(uri-map) | null
    • runtime string | null

      The Runtime version that will be used to run the Build.

      Values are node8, node10, node12, or node14.

    • service_sid string | null

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

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^ZS[0-9a-fA-F]{32}$.

    • sid string | null

      The unique string that identifies the Build resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^ZB[0-9a-fA-F]{32}$.

    • status string | null

      The status of the Build

      Values are building, completed, or failed.

    • url string(uri) | null

      The absolute URL of the Build resource
POST /v1/Services/{ServiceSid}/Builds 
curl \
 -X POST https://serverless.twilio.com/v1/Services/{ServiceSid}/Builds \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'AssetVersions=string&Dependencies=string&FunctionVersions=string&Runtime=string'
Request example 
{
  "AssetVersions": [
    "string"
  ],
  "Dependencies": "string",
  "FunctionVersions": [
    "string"
  ],
  "Runtime": "string"
}
Request examples 
{
  "AssetVersions": [
    "string"
  ],
  "Dependencies": "string",
  "FunctionVersions": [
    "string"
  ],
  "Runtime": "string"
}
Response examples (201) 
{
  "account_sid": "string",
  "asset_versions": [],
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "dependencies": [],
  "function_versions": [],
  "links": {},
  "runtime": "node8",
  "service_sid": "string",
  "sid": "string",
  "status": "building",
  "url": "https://example.com"
}
Response examples (201) 
{
  "account_sid": "string",
  "asset_versions": [],
  "date_created": "2024-05-04T09:42:00+00:00",
  "date_updated": "2024-05-04T09:42:00+00:00",
  "dependencies": [],
  "function_versions": [],
  "links": {},
  "runtime": "node8",
  "service_sid": "string",
  "sid": "string",
  "status": "building",
  "url": "https://example.com"
}