PUT api/v1/admin/tasks/account/{id}

Updates an existing task on the account.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The ID of the task that is being updated.	globally unique identifier	Required

Body Parameters

The new details of the task

TwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskUpdateRequest

Name	Description	Type	Additional information
Enabled	Determines whether the task registered on the account is enabled or disabled.	boolean	None.
TaskID	The ID of the task to be registered.	globally unique identifier	Required
Frequency	How often the task should run.	TwoSms.Platform.Database.CustomerPortal.Tables.Task.Frequency	Required
StartDate	Determines when the task should start running.	date	None.
FinishDate	Determines when the task should stop running.	date	None.
Parameters	The parameters for the task.	string	Required
ContentType	The format the parameters are in. Must either be application/xml or application/json.	string	Required
Notification	Determines the notifications the task could send back to the user.	TwoSms.Platform.Database.CustomerPortal.Tables.Task.TaskNotification	None.

Request Formats

application/json, text/json

Sample:

{
  "Enabled": true,
  "TaskID": "666cbd5f-c471-49d4-8692-500b49f58112",
  "Frequency": 0,
  "StartDate": "2025-01-18T05:12:10.6738315+00:00",
  "FinishDate": "2025-01-18T05:12:10.6738315+00:00",
  "Parameters": "sample string 3",
  "ContentType": "sample string 4",
  "Notification": 0
}

application/xml, text/xml

Sample:

<AccountTaskUpdateRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <TaskID>666cbd5f-c471-49d4-8692-500b49f58112</TaskID>
  <Frequency>NONE</Frequency>
  <StartDate>2025-01-18T05:12:10.6738315+00:00</StartDate>
  <FinishDate>2025-01-18T05:12:10.6738315+00:00</FinishDate>
  <Parameters>sample string 3</Parameters>
  <ContentType>sample string 4</ContentType>
  <Notification>NONE</Notification>
  <Enabled>true</Enabled>
</AccountTaskUpdateRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'System.Web.Http.ModelBinding.JQueryMvcFormUrlEncodedFormatter' to write type 'TwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskUpdateRequest'.

Response Information

Resource Description

TwoSms.CustomerPortalRole.API.Misc.ResponseOfTwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskResponse

Name	Description	Type	Additional information
Error		TwoSms.CustomerPortalRole.API.Misc.Error	None.
ResponseData		TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfTwoSms.CustomerPortalRole.API.Admin.Tasks.AccountTaskResponse	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "ID": "2c90e79c-4f77-40ac-86eb-4773f92b98ec",
      "TaskID": "0c952aec-299d-41b1-a947-9b5be267e3cc",
      "Name": "sample string 3",
      "Enabled": true,
      "Frequency": "sample string 5",
      "StartDate": "2025-01-18T05:12:10.6875867+00:00",
      "FinishDate": "2025-01-18T05:12:10.6875867+00:00",
      "Parameters": "sample string 7",
      "ContentType": "sample string 8",
      "Notification": "sample string 9",
      "DateCreated": "2025-01-18T05:12:10.6875867+00:00",
      "DateModified": "2025-01-18T05:12:10.6875867+00:00",
      "LastRunOn": "2025-01-18T05:12:10.6875867+00:00",
      "LastRunBy": "sample string 11",
      "LastModifiedBy": "sample string 12",
      "Status": "sample string 13",
      "ClientID": "9cd52704-5455-4a7d-a69e-d2156fe36dc1"
    }
  }
}