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

POST /v1/Services/{ServiceSid}/Builds
Account sid auth token

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.

application/x-www-form-urlencoded

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}$.

  • 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}$.

  • Dependencies string

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

  • Runtime string

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

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

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

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

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

    • 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}$.

    • 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}$.

    • status string

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

      Values are building, completed, or failed.

    • asset_versions array | null

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

    • function_versions array | null

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

    • dependencies array | null

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

    • runtime string

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

      Values are node8, node10, node12, node14, node16, node18, node20, or node22.

    • date_created string(date-time) | null

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

    • date_updated string(date-time) | null

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

    • url string(uri) | null

      The absolute URL of the Build resource.

    • links object(uri-map) | null
POST /v1/Services/{ServiceSid}/Builds 
curl \
 --request POST 'https://serverless.twilio.com/v1/Services/{ServiceSid}/Builds' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'Dependencies=%5B%7B%22name%22%3A%22twilio%22%2C+%22version%22%3A%223.29.2%22%7D%2C+%7B%22name%22%3A%22%40twilio%2Fruntime-handler%22%2C+%22version%22%3A+%221.0.1%22%7D%5D&AssetVersions=ZN00000000000000000000000000000000&FunctionVersions=ZN00000000000000000000000000000001'
Request example 
{"Dependencies"=>"[{\"name\":\"twilio\", \"version\":\"3.29.2\"}, {\"name\":\"@twilio/runtime-handler\", \"version\": \"1.0.1\"}]", "AssetVersions"=>["ZN00000000000000000000000000000000"], "FunctionVersions"=>["ZN00000000000000000000000000000001"]}
Response examples (201) 
{
  "sid": "ZB00000000000000000000000000000000",
  "url": "https://serverless.twilio.com/v1/Services/ZS00000000000000000000000000000000/Builds/ZB00000000000000000000000000000000",
  "links": {
    "build_status": "https://serverless.twilio.com/v1/Services/ZS00000000000000000000000000000000/Builds/ZB00000000000000000000000000000000/Status"
  },
  "status": "building",
  "runtime": "node22",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "service_sid": "ZS00000000000000000000000000000000",
  "date_created": "2018-11-10T20:00:00Z",
  "date_updated": "2018-11-10T20:00:00Z",
  "dependencies": [
    {
      "name": "twilio",
      "version": "3.29.2"
    },
    {
      "name": "@twilio/runtime-handler",
      "version": "1.0.1"
    }
  ],
  "asset_versions": [
    {
      "sid": "ZN00000000000000000000000000000000",
      "path": "/asset-path",
      "asset_sid": "ZH00000000000000000000000000000000",
      "visibility": "PUBLIC",
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "service_sid": "ZS00000000000000000000000000000000",
      "date_created": "2018-11-10T20:00:00Z"
    }
  ],
  "function_versions": [
    {
      "sid": "ZN00000000000000000000000000000001",
      "path": "/function-path",
      "visibility": "PUBLIC",
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "service_sid": "ZS00000000000000000000000000000000",
      "date_created": "2018-11-10T20:00:00Z",
      "function_sid": "ZH00000000000000000000000000000001"
    }
  ]
}