Fetch Task Details
POST/fetchTasks
This method returns a list of provisioning tasks, that correspond to a particular IT Application (e.g Microsoft Active Directory) modeled in SSM as "Endpoint" of a "Security System".
The Authorization must have Bearer followed by Token.
Mandatory params:
TASKSTATUS - PENDING/PENDINGCREATE/COMPLETED/COMPLETED_AND_DISCONTINUE/DISCONTINUE,
Optional params:
endpoint - endpoint key,
endpointname, endpointdescription,
securitysystem - securitysystem key,
loggedinusername - username of user who wants to fetch the tasks,
upadteuser,
requestedby,
username,
firstname,
lastname,
account - accountname,
entitlement_value,
entitlement_glossary,
entitlementowner - entitlementowner key,
entitlementtypekey,
requestid,
parenttaskid,
taskid,
taskowneruser - userkey of owner,
taskownerusername - username of owner,
taskownerusergroup - usergroup key,
taskownerusergroupname - usergroup name,
max, offset,
statusint - List of comma-seperated integer equivalent task status(3 - Complete, 4 - Discontinue and so on)
source - List of comma-seperated source types(REQUEST/WEBSERVICE/CERTIFICATION and so on)
requestkey - List of comma-seperated requestkeys
requestaccesskey - List of comma-seperated requestaccesskey
tasktype - List of comma-seperated integer equivalent task types(3 - New Account, 5 - Change Password and so on)
getEntitlementObj - Values: true/false, if true returns the entitlement details associated with the task
getAccountObj - Values: true/false, if true returns the account details asociated with the task,
taskmetadatalength - Modifies the charcater limit of provisioning comments and provisioning metadata upto maximum of 10000.
Note - Provisioning comments in the response will be limited to 200 characters. Provisioning metadata in the response will be limited to 400 characters.
Request
Path Parameters
- multipart/form-data
Body
Responses
- 200
Fetch Task Details
Response Headers
- Access-Control-Allow-Credentials - string 
- Access-Control-Allow-Origin - string 
- Cache-Control - string 
- Date - string 
- Expires - string 
- Pragma - string 
- Referrer-Policy - string 
- Server - string 
- Set-Cookie - string 
- Strict-Transport-Security - string 
- Transfer-Encoding - string 
- X-Content-Type-Options - string 
- X-Frame-Options - string 
- X-XSS-Protection - string 
- application/json
- Schema
- Example (from schema)
- Fetch Task Details
Schema
- Array [ 
- ] 
tasks
object[]
{
  "errorCode": "0",
  "msg": "Successful",
  "tasks": [
    {
      "ACCOUNT": "bsimpson5",
      "COMMENTS": "add a comment",
      "CREATIONDATE": "2021-01-04 20:27:34",
      "ENDDATE": "",
      "ENDPOINT": "Active Directory Plus",
      "ENDPOINTKEY": "604",
      "ENDPOINTNAME": "ActiveDirectoryPlus",
      "ENTITLEMENTTYPE": "",
      "ENTITLEMENT_VALUEKEY": "",
      "OWNERKEY": "admin",
      "PARENTTASK": "",
      "PROVISIONINGCOMMENTS": "",
      "PROVISIONINGMETADATA": "",
      "REQUESTACCESSKEY": "",
      "REQUESTID": "",
      "REQUESTKEY": "",
      "SECURITYSYSTEM": "Active Directory Plus",
      "STARTDATE": "",
      "STATUS": "New",
      "TASKID": "10642653",
      "TASKTYPE": "Change Password",
      "UPDATEDATE": "2021-01-04 20:27:34",
      "USER": "bsimpson5",
      "upadteuser": "bsimpson5(2021-01-04 20:27:34)"
    },
    {
      "ACCOUNT": "$1V9000-2LO73GT330CI",
      "COMMENTS": "add a comment",
      "CREATIONDATE": "2021-02-17 04:27:54",
      "ENDDATE": "",
      "ENDPOINT": "Active Directory Plus",
      "ENDPOINTKEY": "604",
      "ENDPOINTNAME": "ActiveDirectoryPlus",
      "ENTITLEMENTTYPE": "",
      "ENTITLEMENT_VALUEKEY": "",
      "OWNERKEY": "admin",
      "PARENTTASK": "",
      "PROVISIONINGCOMMENTS": "",
      "PROVISIONINGMETADATA": "",
      "REQUESTACCESSKEY": "",
      "REQUESTID": "",
      "REQUESTKEY": "",
      "SECURITYSYSTEM": "Active Directory Plus",
      "STARTDATE": "",
      "STATUS": "New",
      "TASKID": "10642774",
      "TASKTYPE": "Change Password",
      "UPDATEDATE": "2021-02-17 04:27:54",
      "USER": "",
      "upadteuser": "admin(2021-02-17 04:27:54)"
    }
  ],
  "totalrecords": "2",
  "totaltasks": "2"
}
{
  "errorCode": "0",
  "msg": "Successful",
  "tasks": [
    {
      "ACCOUNT": "bsimpson5",
      "COMMENTS": "add a comment",
      "CREATIONDATE": "2021-01-04 20:27:34",
      "ENDDATE": "",
      "ENDPOINT": "Active Directory Plus",
      "ENDPOINTKEY": "604",
      "ENDPOINTNAME": "ActiveDirectoryPlus",
      "ENTITLEMENTTYPE": "",
      "ENTITLEMENT_VALUEKEY": "",
      "OWNERKEY": "admin",
      "PARENTTASK": "",
      "PROVISIONINGCOMMENTS": "",
      "PROVISIONINGMETADATA": "",
      "REQUESTACCESSKEY": "",
      "REQUESTID": "",
      "REQUESTKEY": "",
      "SECURITYSYSTEM": "Active Directory Plus",
      "STARTDATE": "",
      "STATUS": "New",
      "TASKID": "10642653",
      "TASKTYPE": "Change Password",
      "UPDATEDATE": "2021-01-04 20:27:34",
      "USER": "bsimpson5",
      "upadteuser": "bsimpson5(2021-01-04 20:27:34)"
    },
    {
      "ACCOUNT": "$1V9000-2LO73GT330CI",
      "COMMENTS": "add a comment",
      "CREATIONDATE": "2021-02-17 04:27:54",
      "ENDDATE": "",
      "ENDPOINT": "Active Directory Plus",
      "ENDPOINTKEY": "604",
      "ENDPOINTNAME": "ActiveDirectoryPlus",
      "ENTITLEMENTTYPE": "",
      "ENTITLEMENT_VALUEKEY": "",
      "OWNERKEY": "admin",
      "PARENTTASK": "",
      "PROVISIONINGCOMMENTS": "",
      "PROVISIONINGMETADATA": "",
      "REQUESTACCESSKEY": "",
      "REQUESTID": "",
      "REQUESTKEY": "",
      "SECURITYSYSTEM": "Active Directory Plus",
      "STARTDATE": "",
      "STATUS": "New",
      "TASKID": "10642774",
      "TASKTYPE": "Change Password",
      "UPDATEDATE": "2021-02-17 04:27:54",
      "USER": "",
      "upadteuser": "admin(2021-02-17 04:27:54)"
    }
  ],
  "totalrecords": "2",
  "totaltasks": "2"
}