<h1>PUT api/reportserver/v2/scheduledtasks</h1>
<div>
<p>
Updates a scheduled task.
</p>

<h2>Request Information</h2>

<h3>URI Parameters</h3>
<p>None.</p>

<h3>Body Parameters</h3>

<p>Scheduled task model.</p>

<a href="/implementer-guide/apis/rest-api/v2/scheduledtask">ScheduledTask</a>

<table class="help-page-table">
<thead>
<tr><th>Name</th><th>Description</th><th>Type</th><th>Additional information</th></tr>
</thead>
<tbody>
<tr>
<td class="parameter-name">Id</td>
<td class="parameter-documentation">
<p>
Provides the scheduled task identifier.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">UserId</td>
<td class="parameter-documentation">
<p>
Specifies the ID of the user who has created the scheduled task.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">Name</td>
<td class="parameter-documentation">
<p>
Gets or sets the scheduled task name.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">Enabled</td>
<td class="parameter-documentation">
<p>
Gets or sets whether the scheduled task is either enabled or disabled.
</p>
</td>
<td class="parameter-type">
boolean

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">Reports</td>
<td class="parameter-documentation">
<p>
Gets or sets the reports which are rendered by the scheduled task.
</p>
</td>
<td class="parameter-type">
Collection of <a href="/implementer-guide/apis/rest-api/v2/scheduledtaskreport">ScheduledTaskReport</a>

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">StartDate</td>
<td class="parameter-documentation">
<p>
Obsolete since R2 2020. Use StartDateUtc property instead.
Gets or sets the start date of the scheduled task in the author local time zone.
</p>
</td>
<td class="parameter-type">
date

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">StartDateUtc</td>
<td class="parameter-documentation">
<p>
Gets or sets the start date of the scheduled task in UTC.
</p>
</td>
<td class="parameter-type">
date

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">BaseUtcOffset</td>
<td class="parameter-documentation">
<p>
Gets or sets the UTC offset to the local timezone of the
scheduled task author.
Used for the mail templates date time type tokens.
</p>
</td>
<td class="parameter-type">
decimal number

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">RecurrenceRule</td>
<td class="parameter-documentation">
<p>
Gets or sets recurrence rule for the scheduled task.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/recurrencerule">RecurrenceRule</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">LocalUsersMailTemplate</td>
<td class="parameter-documentation">
<p>
Gets or sets the mail template for local users. Set to null to use the default template.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/taskmailtemplatemodel">TaskMailTemplateModel</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">ExternalUsersMailTemplate</td>
<td class="parameter-documentation">
<p>
Gets or sets the mail template for external users. Set to null to use the default template.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/taskmailtemplatemodel">TaskMailTemplateModel</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">ExternalEmails</td>
<td class="parameter-documentation">
<p>
Gets or sets the emails of the external users to whom the report document should be sent.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">SubscriberIds</td>
<td class="parameter-documentation">
<p>
Provides a list of IDs of the users subscribed to the data alert.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
</tbody>
</table>
<h3>Request body formats</h3>
<div>
<h4 class="sample-header">application/json, text/json</h4>
<div class="sample-content">

```json
{
  "Id": "2e5884f62ed",
  "UserId": "8ca92edf5b114683b7838e29514e7f89",
  "Name": "Marketing Reports",
  "Enabled": true,
  "Reports": [
    {
      "ReportId": "b4ef456a101",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    },
    {
      "ReportId": "e441aa14755",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    }
  ],
  "StartDate": "2026-11-11T15:21:26.5037057+00:00",
  "StartDateUtc": "2026-11-11T15:21:26.5037057Z",
  "BaseUtcOffset": 1931.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": [
    "41a35f5816eb4bc191dd7513144c418f",
    "3522cdf50e9e441a857e736753dcd583"
  ]
}
```

</div>
</div>

<h2>Response Information</h2>

<h3>Resource Description</h3>

<p></p>

<a href="/implementer-guide/apis/rest-api/v2/scheduledtask">ScheduledTask</a>

<table class="help-page-table">
<thead>
<tr><th>Name</th><th>Description</th><th>Type</th><th>Additional information</th></tr>
</thead>
<tbody>
<tr>
<td class="parameter-name">Id</td>
<td class="parameter-documentation">
<p>
Provides the scheduled task identifier.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">UserId</td>
<td class="parameter-documentation">
<p>
Specifies the ID of the user who has created the scheduled task.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">Name</td>
<td class="parameter-documentation">
<p>
Gets or sets the scheduled task name.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">Enabled</td>
<td class="parameter-documentation">
<p>
Gets or sets whether the scheduled task is either enabled or disabled.
</p>
</td>
<td class="parameter-type">
boolean

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">Reports</td>
<td class="parameter-documentation">
<p>
Gets or sets the reports which are rendered by the scheduled task.
</p>
</td>
<td class="parameter-type">
Collection of <a href="/implementer-guide/apis/rest-api/v2/scheduledtaskreport">ScheduledTaskReport</a>

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">StartDate</td>
<td class="parameter-documentation">
<p>
Obsolete since R2 2020. Use StartDateUtc property instead.
Gets or sets the start date of the scheduled task in the author local time zone.
</p>
</td>
<td class="parameter-type">
date

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">StartDateUtc</td>
<td class="parameter-documentation">
<p>
Gets or sets the start date of the scheduled task in UTC.
</p>
</td>
<td class="parameter-type">
date

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">BaseUtcOffset</td>
<td class="parameter-documentation">
<p>
Gets or sets the UTC offset to the local timezone of the
scheduled task author.
Used for the mail templates date time type tokens.
</p>
</td>
<td class="parameter-type">
decimal number

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">RecurrenceRule</td>
<td class="parameter-documentation">
<p>
Gets or sets recurrence rule for the scheduled task.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/recurrencerule">RecurrenceRule</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">LocalUsersMailTemplate</td>
<td class="parameter-documentation">
<p>
Gets or sets the mail template for local users. Set to null to use the default template.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/taskmailtemplatemodel">TaskMailTemplateModel</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">ExternalUsersMailTemplate</td>
<td class="parameter-documentation">
<p>
Gets or sets the mail template for external users. Set to null to use the default template.
</p>
</td>
<td class="parameter-type">
<a href="/implementer-guide/apis/rest-api/v2/taskmailtemplatemodel">TaskMailTemplateModel</a>

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">ExternalEmails</td>
<td class="parameter-documentation">
<p>
Gets or sets the emails of the external users to whom the report document should be sent.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">SubscriberIds</td>
<td class="parameter-documentation">
<p>
Provides a list of IDs of the users subscribed to the data alert.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
</tbody>
</table>

<h3>Response Formats</h3>
<div>
<h4 class="sample-header">application/json, text/json</h4>
<div class="sample-content">

```json
{
  "Id": "2e5884f62ed",
  "UserId": "8ca92edf5b114683b7838e29514e7f89",
  "Name": "Marketing Reports",
  "Enabled": true,
  "Reports": [
    {
      "ReportId": "b4ef456a101",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    },
    {
      "ReportId": "e441aa14755",
      "DocumentFormat": "Pdf",
      "Parameters": {
        "OrderDate": "2024-01-15",
        "Region": "North America"
      }
    }
  ],
  "StartDate": "2026-11-11T15:21:26.5037057+00:00",
  "StartDateUtc": "2026-11-11T15:21:26.5037057Z",
  "BaseUtcOffset": 1931.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": [
    "41a35f5816eb4bc191dd7513144c418f",
    "3522cdf50e9e441a857e736753dcd583"
  ]
}
```

</div>
</div>
</div>
