Subscription

View as Markdown

Get schedule subscriptionGET /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions/{subscription_id}List schedule subscriptionsGET /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptionsCreate schedule subscriptionPOST /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptionsDelete schedule subscriptionDELETE /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions/{subscription_id}

Subscription object

subscription_idstringOutput only

UUID identifying the subscription.

Example: 01ee9e6f2a2c1a8d9273d3c3e852fc2b

schedule_idstringOutput only

UUID identifying the schedule to which the subscription belongs.

Example: 01ef0cb45e2a1da4a61950e9b8789ce9

dashboard_idstringOutput only

UUID identifying the dashboard to which the subscription belongs.

Example: 04aab30f99ea444490c10c85852f216c

subscriberobject

Subscriber details for users and destinations to be added as subscribers to the schedule.

Show child attributesHide child attributes

user_subscriberobject

The user to receive the subscription email. This parameter is mutually exclusive with destination_subscriber.

Show child attributesHide child attributes

user_idint64

UserId of the subscriber.

Example: 3294322584244938

destination_subscriberobject

The destination to receive the subscription email. This parameter is mutually exclusive with user_subscriber.

Show child attributesHide child attributes

destination_idstring

The canonical identifier of the destination to receive email notification.

Example: ce8f875a-11ad-4117-bcc6-c5a542822aee

created_by_user_idint64Output only

UserId of the user who adds subscribers (users or notification destinations) to the dashboard's schedule.

Example: 3294322584244938

etagstring

The etag for the subscription. Must be left empty on create, can be optionally provided on delete to ensure that the subscription has not been deleted since the last read.

Example: 80611980

create_timestringOutput only

A timestamp indicating when the subscription was created.

update_timestringOutput only

A timestamp indicating when the subscription was last updated.

skip_notifyboolean

Controls whether notifications are sent to the subscriber for scheduled dashboard refreshes. If not defined, defaults to false in the backend to match the current behavior (refresh and notify)

View as Markdown

The Subscription object

{
  "subscription_id": "01ee9e6f2a2c1a8d9273d3c3e852fc2b",
  "schedule_id": "01ef0cb45e2a1da4a61950e9b8789ce9",
  "dashboard_id": "04aab30f99ea444490c10c85852f216c",
  "subscriber": {
    "user_subscriber": {},
    "destination_subscriber": {}
  },
  "created_by_user_id": "3294322584244938",
  "etag": "80611980",
  "create_time": "string",
  "update_time": "string",
  "skip_notify": true
}

Get schedule subscription GA

GET /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions/{subscription_id}

Get schedule subscription.

API scopes: dashboards

Parameters

dashboard_idstringRequiredpath

UUID identifying the dashboard which the subscription belongs.

Example: 04aab30f99ea444490c10c85852f216c

schedule_idstringRequiredpath

UUID identifying the schedule which the subscription belongs.

Example: 01ef0cb45e2a1da4a61950e9b8789ce9

subscription_idstringRequiredpath

UUID identifying the subscription.

Example: 01ee9e6f2a2c1a8d9273d3c3e852fc2b

Response

Returns the Subscription object.

View as Markdown

Response

{
  "subscription_id": "01ee9e6f2a2c1a8d9273d3c3e852fc2b",
  "schedule_id": "01ef0cb45e2a1da4a61950e9b8789ce9",
  "dashboard_id": "04aab30f99ea444490c10c85852f216c",
  "subscriber": {
    "user_subscriber": {},
    "destination_subscriber": {}
  },
  "created_by_user_id": "3294322584244938",
  "etag": "80611980",
  "create_time": "string",
  "update_time": "string",
  "skip_notify": true
}

List schedule subscriptions GA

GET /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions

List schedule subscriptions.

API scopes: dashboards

Parameters

dashboard_idstringRequiredpath

UUID identifying the dashboard which the subscriptions belongs.

Example: 04aab30f99ea444490c10c85852f216c

schedule_idstringRequiredpath

UUID identifying the schedule which the subscriptions belongs.

Example: 01ef0cb45e2a1da4a61950e9b8789ce9

page_sizeint32[ 1 .. 100 ]query

The number of subscriptions to return per page.

Default: 20

page_tokenstringquery

A page token, received from a previous ListSubscriptions call. Use this to retrieve the subsequent page.

Example: EAI=

Response

Returns a list of Subscription objects.

View as Markdown

Response

{
  "subscriptions": [
    {
      "subscription_id": "01ee9e6f2a2c1a8d9273d3c3e852fc2b",
      "schedule_id": "01ef0cb45e2a1da4a61950e9b8789ce9",
      "dashboard_id": "04aab30f99ea444490c10c85852f216c",
      "subscriber": {},
      "created_by_user_id": "3294322584244938",
      "etag": "80611980",
      "create_time": "string",
      "update_time": "string",
      "skip_notify": true
    }
  ],
  "next_page_token": "EAI="
}

Create schedule subscription GA

POST /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions

Create schedule subscription.

API scopes: dashboards

Parameters

dashboard_idstringRequiredpath

UUID identifying the dashboard to which the subscription belongs.

Example: 04aab30f99ea444490c10c85852f216c

schedule_idstringRequiredpath

UUID identifying the schedule to which the subscription belongs.

Example: 01ef0cb45e2a1da4a61950e9b8789ce9

Request body

The subscription to create. A schedule is limited to 100 subscriptions.

subscriberobjectRequired

Subscriber details for users and destinations to be added as subscribers to the schedule.

Show child attributesHide child attributes

user_subscriberobject

The user to receive the subscription email. This parameter is mutually exclusive with destination_subscriber.

Show child attributesHide child attributes

user_idint64Required

UserId of the subscriber.

Example: 3294322584244938

destination_subscriberobject

The destination to receive the subscription email. This parameter is mutually exclusive with user_subscriber.

Show child attributesHide child attributes

destination_idstringRequired

The canonical identifier of the destination to receive email notification.

Example: ce8f875a-11ad-4117-bcc6-c5a542822aee

skip_notifyboolean

Controls whether notifications are sent to the subscriber for scheduled dashboard refreshes. If not defined, defaults to false in the backend to match the current behavior (refresh and notify)

Response

Returns the Subscription object.

View as Markdown

Request

{
  "subscriber": {
    "user_subscriber": {},
    "destination_subscriber": {}
  },
  "skip_notify": true
}

Response

{
  "subscription_id": "01ee9e6f2a2c1a8d9273d3c3e852fc2b",
  "schedule_id": "01ef0cb45e2a1da4a61950e9b8789ce9",
  "dashboard_id": "04aab30f99ea444490c10c85852f216c",
  "subscriber": {
    "user_subscriber": {},
    "destination_subscriber": {}
  },
  "created_by_user_id": "3294322584244938",
  "etag": "80611980",
  "create_time": "string",
  "update_time": "string",
  "skip_notify": true
}

Delete schedule subscription GA

DELETE /api/2.0/lakeview/dashboards/{dashboard_id}/schedules/{schedule_id}/subscriptions/{subscription_id}

Delete schedule subscription.

API scopes: dashboards

Parameters

dashboard_idstringRequiredpath

UUID identifying the dashboard which the subscription belongs.

Example: 04aab30f99ea444490c10c85852f216c

schedule_idstringRequiredpath

UUID identifying the schedule which the subscription belongs.

Example: 01ef0cb45e2a1da4a61950e9b8789ce9

subscription_idstringRequiredpath

UUID identifying the subscription.

Example: 01ee9e6f2a2c1a8d9273d3c3e852fc2b

etagstringquery

The etag for the subscription. Can be optionally provided to ensure that the subscription has not been modified since the last read.

Example: 80611980

View as Markdown

Response

{}