Power policies API

GET/v1/power-policies

List the power policies configured for your workspace. Each policy defines an open and close window for the screens using it. **Notes.** - Needs the permission at the workspace root: a location-scoped key is refused.

curl "https://api.brixsignage.com/v1/power-policies" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

{
  "data": [
    {
      "id": "ppol_1a2b3c4d5e6f7a8b",
      "spaceId": "space_1a2b3c4d5e6f7a8b",
      "name": "Store hours",
      "description": "Open 8 to 22",
      "windows": {
        "mon": {
          "start": "08:00",
          "end": "22:00"
        },
        "tue": {
          "start": "08:00",
          "end": "22:00",
          "volume": 40
        }
      },
      "rebootHourLocal": 4,
      "timezone": "Europe/London",
      "createdAt": "2026-09-28T09:00:00.000Z",
      "updatedAt": "2026-09-28T09:00:00.000Z",
      "deletedAt": null,
      "screenCount": 12
    }
  ]
}

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/power-policies

Create a named power policy that defines when screens using it should power on and off. **Notes.** - Needs the permission at the workspace root: a location-scoped key is refused.

Request body application/json

curl -X POST "https://api.brixsignage.com/v1/power-policies" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 201 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 422 Unknown `timezone`.

Response 5XX Server error. The body carries a `requestId` to quote to support.

GET/v1/power-policies/{id}

Get one power policy by its ID. **Notes.** - Needs the permission at the workspace root: a location-scoped key is refused.

curl "https://api.brixsignage.com/v1/power-policies/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such power policy in this workspace.

Response 5XX Server error. The body carries a `requestId` to quote to support.

PATCH/v1/power-policies/{id}

Update a power policy's open and close windows, reboot hour, time zone, or name. **Notes.** - screenCount in this response is always 0; read the policy to get the real count. - An empty name keeps the current name. - Needs the permission at the workspace root: a location-scoped key is refused.

Request body application/json

curl -X PATCH "https://api.brixsignage.com/v1/power-policies/{id}" \
  -H "Authorization: Bearer $BRIX_API_KEY" \
  -H "Content-Type: application/json"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such power policy in this workspace.

Response 422 Unknown `timezone`.

Response 5XX Server error. The body carries a `requestId` to quote to support.

POST/v1/power-policies/{id}/delete

Delete a power policy. Screens that use it go back to their own operating hours. A deleted policy cannot be restored. **Notes.** - A POST to /delete, not DELETE. Screens that use the policy keep the link and use their own operating hours until they get another policy. There is no restore route. - Needs the permission at the workspace root: a location-scoped key is refused.

curl -X POST "https://api.brixsignage.com/v1/power-policies/{id}/delete" \
  -H "Authorization: Bearer $BRIX_API_KEY"

Response 200 Success.

Response 401 Missing, expired or revoked bearer token.

Response 403 The token lacks the permission this operation needs (see `x-brix-permission`).

Response 404 No such power policy in this workspace.

Response 5XX Server error. The body carries a `requestId` to quote to support.