Builds

Builds are the execution step of the release workflow. This page focuses on build lookup, status polling, and the request/response shapes you usually need in operational code.

Familyclient.builds

Builds

Attribute	Data type	Description
find(build_id)	Build	Fetches a single build by ID.
list_for_library(library_id)	Array<Build>	Lists builds produced for the library.
republish(build_id)	Build	Reissues a build using Adobe's republish action.

Polling

Build polling

# build = Build resource returned by client.libraries.build(...).
# Keep polling until Adobe marks the build as succeeded or failed.
loop do
  # Refresh the build from Reactor using its Adobe build ID.
  build = client.builds.find(build.id)
  # Exit once the build reaches a terminal state.
  break if build.succeeded? || build.failed?
  # Wait 30 seconds before polling again.
  sleep 30
end

Raw API mapping

Sample: trigger a build for a library

POST /libraries/:library_id/builds

# LB... = library ID.
# Trigger a new build for the library.
curl -s -X POST "https://reactor.adobe.io/libraries/LB1234567890abcdef1234567890abcd/builds" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-api-key: YOUR_ADOBE_CLIENT_ID" \
  -H "x-gw-ims-org-id: YOUR_IMS_ORG_ID" \
  -H "Accept: application/vnd.api+json;revision=1" \
  -H "Content-Type: application/vnd.api+json"

Sample response

{
  "data": {
    // BL... = build ID.
    "id": "BL1234567890abcdef1234567890abcd",
    "type": "builds",
    "attributes": {
      // Current build status.
      "status": "pending",
      // Adobe creation timestamp.
      "created_at": "2026-03-27T08:16:21.000Z",
      // Adobe last-update timestamp.
      "updated_at": "2026-03-27T08:16:21.000Z"
    }
  }
}

Sample: poll a build until it completes

GET /builds/:build_id

# BL... = build ID.
# Poll the current status of one build.
curl -s "https://reactor.adobe.io/builds/BL1234567890abcdef1234567890abcd" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-api-key: YOUR_ADOBE_CLIENT_ID" \
  -H "x-gw-ims-org-id: YOUR_IMS_ORG_ID" \
  -H "Accept: application/vnd.api+json;revision=1"

Sample response

{
  "data": {
    // BL... = build ID being polled.
    "id": "BL1234567890abcdef1234567890abcd",
    "type": "builds",
    "attributes": {
      // Terminal build status in this example.
      "status": "succeeded",
      // Adobe creation timestamp.
      "created_at": "2026-03-27T08:16:21.000Z",
      // Adobe last-update timestamp after the build completed.
      "updated_at": "2026-03-27T08:18:02.000Z"
    }
  }
}