# Deep Security Manager REST API

## Path: / rest / tasks / scheduled / {scheduledTaskID} / recipients / administrators

Modify a scheduled task's recipients list to add administrators.

Path parameters:
  scheduledTaskID - the scheduled task identifier.

Resources
Name | Description
--- | ---
{administratorID} | Remove an administrator from a scheduled task's recipients list.

Method Summary
Resource | Description
--- | ---
`PUT /rest/tasks/scheduled/{scheduledTaskID}/recipients/administrators` | Modify a scheduled task's recipients list with a new (complete) list of administrators.
`POST /rest/tasks/scheduled/{scheduledTaskID}/recipients/administrators` | Modify a scheduled task's recipients list to add administrators.

Method Detail
Modify a scheduled task's recipients list with a new (complete) list of administrators. Input: `ModifyAdministratorsListRequest` - a {@link ModifyAdministratorsListRequest} with the details of the administrators list. Output: `ModifyAdministratorsListResponse` - a {@link ModifyAdministratorsListResponse} with the updated administrators list details. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 400 - if the task does not support a recipients list 403 - if the user is not authorized to modify scheduled tasks or if the requested modification is not permitted 404 - if the user is authorized to modify scheduled tasks but the scheduled task does not exist
Modify a scheduled task's recipients list to add administrators. Input: `ModifyAdministratorsListRequest` - a {@link ModifyAdministratorsListRequest} with the details of the administrators list. Output: `ModifyAdministratorsListResponse` - a {@link ModifyAdministratorsListResponse} with the updated administrators list details. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 400 - if the task does not support a recipients list 403 - if the user is not authorized to modify scheduled tasks or if the requested modification is not permitted 404 - if the user is authorized to modify scheduled tasks but the scheduled task does not exist

Copyright © 2017 Trend Micro Inc. All Rights Reserved.