Retrieve a specific Build resource

GET /v1/Services/{ServiceSid}/Builds/{Sid}

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

Retrieve a specific Build resource.

Path parameters

  • ServiceSid string Required

    The SID of the Service to fetch the Build resource from.

  • Sid string Required

    The SID of the Build resource to fetch.

Responses

  • OK

    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

    • 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

GET /v1/Services/{ServiceSid}/Builds/{Sid}
curl \
 -X GET https://serverless.twilio.com/v1/Services/{ServiceSid}/Builds/{Sid} \
 --user "username:password"
Response examples (200)
{
  "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 (200)
{
  "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"
}