Read a platform build request (browser session)

Read one queued build request. Queueing a build answers with a request id before there is a build to read - the build row is created when the scheduler claims the request - so this is how a caller follows that gap: status is pending until the claim, and build_id names the build from then on. Answers 404 for every organisation without the platform_builds flag. Browser session authentication.

GET /org/applications/{application_id}/builds/requests/{request_id}

Read a platform build request (browser session)

Python

import requests

url = "https://api.platform.ankra.app/org/applications/{application_id}/builds/requests/{request_id}"

headers = {"cookie": "ankra_session="}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "request_id": "<string>",
  "component": "<string>",
  "head_sha": "<string>",
  "ref": "<string>",
  "reason": "<string>",
  "status": "<string>",
  "build_id": "<string>",
  "claimed_at": "<string>",
  "created_at": "<string>"
}

Authorizations

ankra_session · string · cookie · required

Browser session. Mutations also require X-Ankra-CSRF.

Path Parameters

application_id · string · required

request_id · string · required

Response

200

application/json

Successful Response

request_id · string · required

component · string · required

head_sha · string · required

ref · string · required

reason · string · required

Why the build was asked for: first_onboard, push, retry or demo.

status · string · required

pending until the scheduler claims the request, then claimed, then done; cancelled if it was withdrawn before a builder took it.

build_id · string | null · required

The build this request was claimed into; null while the request is still pending. Read it at /org/applications/{application_id}/builds/{build_id}.

claimed_at · string | null · required

When a builder claimed the request; null while it is still pending.

created_at · string · required