Tasks

get

Return a task's status

🔒 Requires the read:task permission

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

taskIdstring · uuidRequired

The task's ID e.g. f27d96be-c486-4075-a926-0ee96775119e

Query parameters

expandbooleanOptional

If true, return elaborated version of the status. Otherwise, return a summarized version

Responses

200

Task details

application/json

400

Failed to get task status

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:task permission

application/json

404

Task not found

application/json

429

Too many requests

application/json

get

/api/v1/task/{taskId}/status

HTTPcURLJavaScriptPython

GET /api/v1/task/{taskId}/status HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "task": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "command": "force_install",
  "planOnly": true,
  "deployments": {
    "total": 1,
    "states": {
      "pending": 1,
      "planning": 1,
      "no_change": 1,
      "planned": 1,
      "plan_approved": 1,
      "installing": 1,
      "skipped": 1,
      "canceled": 1,
      "completed": 1,
      "error": 1
    }
  },
  "statusTimestamps": {
    "pending": "2026-01-10T03:45:02.445Z",
    "planning": "2026-01-10T03:45:02.445Z",
    "no_change": "2026-01-10T03:45:02.445Z",
    "planned": "2026-01-10T03:45:02.445Z",
    "plan_approved": "2026-01-10T03:45:02.445Z",
    "installing": "2026-01-10T03:45:02.445Z",
    "completed": "2026-01-10T03:45:02.445Z",
    "canceled": "2026-01-10T03:45:02.445Z",
    "skipped": "2026-01-10T03:45:02.445Z",
    "error": "2026-01-10T03:45:02.445Z"
  },
  "errors": null,
  "created": "2026-01-10T03:45:02.445Z",
  "updated": null,
  "completed": null
}