APIs & SDKs/shadw REST API/Get a build

Get a build

GEThttps://api.shadw.cloud/v1/builds/{id}

Poll a build's status and streamed logs. State is one of building, ready or error.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a short-lived JWT minted with POST /v1/token. An API key scopes the request to the team it was created under.

Path parameters

idstringRequired

The build id returned by Create a deployment.

const response = await fetch('https://api.shadw.cloud/v1/builds/{id}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY', // hive_… (Settings → API Keys)
  },
});

const data = await response.json();
console.log(data);

Response

json

{
  "id": "dpl-9f2a1c7b04",
  "project": "acme-app",
  "state": "ready",
  "branch": "main",
  "commit": "3b273ff",
  "deployment_id": "dpl-46f4fb3397",
  "alias": "acme-app.localhost"
}