Skip to main content
GET
/
v1
/
deployments
/
{deploymentId}
/
notifications
List scheduled notifications
curl --request GET \
  --url https://{tenant}.cubecloud.dev/api/v1/deployments/{deploymentId}/notifications \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "cronExpression": "<string>",
      "dashboardId": 123,
      "deploymentId": 123,
      "humanReadableSchedule": "<string>",
      "id": 123,
      "isEnabled": true,
      "notificationEnabled": true,
      "notificationFormat": "<string>",
      "timezone": "<string>"
    }
  ],
  "pageInfo": {
    "hasNextPage": true,
    "hasPreviousPage": true,
    "endCursor": "<string>",
    "startCursor": "<string>"
  }
}
🔒 Admin only. Requires administrator privileges — the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. Returns the deployment’s scheduled notifications (recurring dashboard runs), ordered by creation time (newest first) and cursor-paginated. Optionally filter to a single dashboard with dashboardId. Each item describes the schedule only; recipients are managed through the /recipients sub-resource.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

deploymentId
integer
required

Numeric id of the deployment that owns the notification.

Query Parameters

dashboardId
integer

Optional filter: only return notifications for this dashboard id.

Required range: x >= 1
first
integer

Page size for cursor pagination (default 100, max 200).

Required range: 1 <= x <= 200
after
string

Opaque cursor for the next page; pass the previous response's pageInfo.endCursor.

Response

200 - application/json
items
object[]
required
pageInfo
object