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

Updates an existing task on the account.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The ID of the task that is being updated.

globally unique identifier

Required

Body Parameters

The new details of the task

AccountTaskUpdateRequest
NameDescriptionTypeAdditional 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

ClientID

The client ID for the task to use.

globally unique identifier

Required

ClientSecret

The client secret for the task to use.

string

Required

Frequency

How often the task should run.

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.

TaskNotification

None.

Request Formats

application/json, text/json

Sample:
{
  "Enabled": true,
  "TaskID": "feea3e7f-2957-4dd5-87e9-003e2b82f4e5",
  "ClientID": "65c0ca3f-8ed4-43e4-8210-3bbec59a6827",
  "ClientSecret": "sample string 3",
  "Frequency": 0,
  "StartDate": "2018-01-22T06:57:25.0205122Z",
  "FinishDate": "2018-01-22T06:57:25.0205122Z",
  "Parameters": "sample string 5",
  "ContentType": "sample string 6",
  "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>feea3e7f-2957-4dd5-87e9-003e2b82f4e5</TaskID>
  <ClientID>65c0ca3f-8ed4-43e4-8210-3bbec59a6827</ClientID>
  <ClientSecret>sample string 3</ClientSecret>
  <Frequency>NONE</Frequency>
  <StartDate>2018-01-22T06:57:25.0205122Z</StartDate>
  <FinishDate>2018-01-22T06:57:25.0205122Z</FinishDate>
  <Parameters>sample string 5</Parameters>
  <ContentType>sample string 6</ContentType>
  <Notification>NONE</Notification>
  <Enabled>true</Enabled>
</AccountTaskUpdateRequest>

Response Information

Resource Description

ResponseOfAccountTaskResponse
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfAccountTaskResponse

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": "3b07bd7d-0d94-4877-970e-8e7c9325a1d3",
      "TaskID": "6867c6a0-cacf-4163-8aee-6af637eda41a",
      "Name": "sample string 3",
      "Enabled": true,
      "Frequency": "sample string 5",
      "StartDate": "2018-01-22T06:57:25.0517572Z",
      "FinishDate": "2018-01-22T06:57:25.0517572Z",
      "Parameters": "sample string 7",
      "ContentType": "sample string 8",
      "Notification": "sample string 9",
      "DateCreated": "2018-01-22T06:57:25.0517572Z",
      "DateModified": "2018-01-22T06:57:25.0517572Z",
      "LastRunOn": "2018-01-22T06:57:25.0517572Z",
      "LastRunBy": "sample string 11",
      "LastModifiedBy": "sample string 12",
      "Status": "sample string 13",
      "ClientID": "648082c9-8cf2-40dc-82b2-1a2c5f075ef6"
    }
  }
}