GET api/reportserver/v3/scheduled-tasks/{scheduledTaskId}
Returns the scheduled task with the specified ID.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| scheduledTaskId |
The scheduled task ID. | string |
Required |
Body Parameters
None.
Response Information
Resource Description
| Name | Description | Type | Additional information |
|---|---|---|---|
| Id |
Provides the scheduled task identifier. | string |
Required |
| UserId |
Specifies the ID of the user who has created the scheduled task. | string |
None. |
| Name |
Gets or sets the scheduled task name. | string |
Required |
| Enabled |
Gets or sets whether the scheduled task is either enabled or disabled. | boolean |
None. |
| Reports |
Gets or sets the reports which are rendered by the scheduled task. | Collection of ScheduledTaskReport |
Required |
| StartDate |
Obsolete since R2 2020. Use StartDateUtc property instead. Gets or sets the start date of the scheduled task in the author local time zone. | date |
None. |
| StartDateUtc |
Gets or sets the start date of the scheduled task in UTC. | date |
None. |
| BaseUtcOffset |
Gets or sets the UTC offset to the local timezone of the scheduled task author. Used for the mail templates date time type tokens. | decimal number |
None. |
| RecurrenceRule |
Gets or sets recurrence rule for the scheduled task. | RecurrenceRule |
None. |
| LocalUsersMailTemplate |
Gets or sets the mail template for local users. Set to null to use the default template. | TaskMailTemplateModel |
None. |
| ExternalUsersMailTemplate |
Gets or sets the mail template for external users. Set to null to use the default template. | TaskMailTemplateModel |
None. |
| ExternalEmails |
Gets or sets the emails of the external users to whom the report document should be sent. | Collection of string |
None. |
| SubscriberIds |
Provides a list of IDs of the users subscribed to the data alert. | Collection of string |
None. |
Response Formats
application/json
{
"Id": "033709a8805",
"UserId": "6f8209072bba4ae38f1b73ef37bf19dc",
"Name": "Marketing Reports",
"Enabled": true,
"Reports": [
{
"ReportId": "0e9b3e0e609",
"DocumentFormat": "Pdf",
"Parameters": {
"OrderDate": "2024-01-15",
"Region": "North America"
}
},
{
"ReportId": "fa1b238fb3d",
"DocumentFormat": "Pdf",
"Parameters": {
"OrderDate": "2024-01-15",
"Region": "North America"
}
}
],
"StartDate": "2026-08-12T14:16:00.1052343+00:00",
"StartDateUtc": "2026-08-12T14:16:00.1052343Z",
"BaseUtcOffset": 499.1,
"RecurrenceRule": null,
"LocalUsersMailTemplate": {
"Subject": "Your scheduled report is ready",
"Body": "The report you subscribed to has been generated and is attached to this email."
},
"ExternalUsersMailTemplate": {
"Subject": "Your scheduled report is ready",
"Body": "The report you subscribed to has been generated and is attached to this email."
},
"ExternalEmails": [
"maria.garcia@example.com",
"alex.johnson@example.com"
],
"SubscriberIds": [
"2c658cd3df9d4ee2b8c41b60873e37ac",
"12f3d91760784e65bf6a031146f2e68b"
]
}