List scheduled report exports

GET

/v2/reports/:reportId/schedules

GET

/v2/reports/:reportId/schedules

$ curl https://api.sigmacomputing.com/v2/reports/reportId/schedules \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "entries": [
3     {
4       "scheduledNotificationId": "string",
5       "reportId": "string",
6       "schedule": {
7         "cronSpec": "string",
8         "timezone": "string"
9       },
10       "configV2": {
11         "title": "string",
12         "messageBody": "string",
13         "notificationAttachments": [
14           {
15             "formatOptions": {
16               "layout": "portrait",
17               "scaleFactor": 1.1,
18               "type": "PDF"
19             },
20             "workbookExportSource": {
21               "type": "report"
22             }
23           }
24         ],
25         "includeLink": true,
26         "runAsRecipient": true,
27         "attachmentSettings": {
28           "mergePdfAttachments": true,
29           "zipAttachments": true
30         },
31         "conditionOptions": {
32           "type": "always"
33         },
34         "alertConfig": {
35           "window": "alltime",
36           "volume": 1.1
37         },
38         "notificationName": "string",
39         "reportSettings": {
40           "filters": [
41             {
42               "id": "string",
43               "filterStr": "string"
44             }
45           ],
46           "variableValues": {}
47         },
48         "dynamicExportSettings": {
49           "variables": {}
50         },
51         "dynamicRecipientSettings": {
52           "sourceNodeId": "string",
53           "recipientColumnId": "string"
54         },
55         "rowLimit": 1.1,
56         "reportVariant": {
57           "tagId": "string"
58         },
59         "embedOpts": {
60           "embedId": "string",
61           "evalConnectionId": "string"
62         }
63       },
64       "isSuspended": true,
65       "ownerId": "string",
66       "lastUpdatedByUser": "string",
67       "disabledAt": "2024-01-15T09:30:00Z",
68       "disabledBy": "string",
69       "createdBy": "string",
70       "updatedBy": "string",
71       "createdAt": "2024-01-15T09:30:00Z",
72       "updatedAt": "2024-01-15T09:30:00Z"
73     }
74   ],
75   "nextPage": "string",
76   "total": 1.1,
77   "hasMore": true
78 }

This endpoint retrieves a list of all scheduled exports for a specified report. These schedules represent planned events that can trigger exports based on various conditions and timings.

Usage Notes

The reportId in the path parameter identifies the report whose scheduled exports are to be listed. Retrieve the reportId by calling the /v2/reports endpoint.
Use pagination query parameters to manage the volume of data returned by this endpoint.

Usage Scenarios

Schedule overview: Administrators or users with appropriate permissions can monitor and review all active scheduled exports associated with a report.
Audit and compliance: This functionality is useful for auditing purposes to ensure that all scheduled operations are configured correctly and comply with organizational policies.

Best Practices

Implement client-side handling to manage paginated data effectively, especially in cases where a report has a large number of scheduled exports.
Regularly audit schedules to keep them up-to-date and aligned with current workflows.

This endpoint retrieves a list of all scheduled exports for a specified report. These schedules represent planned events that can trigger exports based on various conditions and timings. ### Usage Notes - The **reportId** in the path parameter identifies the report whose scheduled exports are to be listed. Retrieve the **reportId** by calling the [/v2/reports](https://help.sigmacomputing.com/reference/list-reports) endpoint. - Use pagination query parameters to manage the volume of data returned by this endpoint. ### Usage Scenarios - **Schedule overview**: Administrators or users with appropriate permissions can monitor and review all active scheduled exports associated with a report. - **Audit and compliance**: This functionality is useful for auditing purposes to ensure that all scheduled operations are configured correctly and comply with organizational policies. ### Best Practices - Implement client-side handling to manage paginated data effectively, especially in cases where a report has a large number of scheduled exports. - Regularly audit schedules to keep them up-to-date and aligned with current workflows.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

reportIdstringRequired

Query parameters

pagestringOptional

limitdoubleOptional

Response

The response body.

entrieslist of objects

Array of results returned by the endpoint

nextPagestring or null

Returns a string that can be used as the page parameter in the next request to fetch the next page of results. The last page of results returns null.

totaldouble

Total number of results. Useful to determine if there is a need to paginate.

hasMoreboolean

[Deprecated] Indicates whether more results are available.