Skip to main content

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​

Body

    sourcestring
    Example: WEBSERVICE
    statusintstring
    Example: 1
    tasktypestring
    Example: 5

Responses​

Fetch Task Details

Response Headers

  • Access-Control-Allow-Credentials

    string

  • Access-Control-Allow-Origin

    string

  • Cache-Control

    string

  • Date

    string

  • Expires

    string

  • Referrer-Policy

    string

  • Server

    string

  • Set-Cookie

    string

  • Strict-Transport-Security

    string

  • X-Content-Type-Options

    string

  • X-Frame-Options

    string

Schema

    errorCodestring
    Example: 0
    msgstring
    Example: Successful

    tasks

    object[]

  • Array [

    • ACCOUNTstring
    Example: bsimpson5
    COMMENTSstring
    Example: add a comment
    CREATIONDATEstring
    Example: 2021-01-04 20:27:34
    ENDDATEstring
    Example:
    ENDPOINTstring
    Example: Active Directory Plus
    ENDPOINTKEYstring
    Example: 604
    ENDPOINTNAMEstring
    Example: ActiveDirectoryPlus
    ENTITLEMENTTYPEstring
    Example:
    ENTITLEMENT_VALUEKEYstring
    Example:
    OWNERKEYstring
    Example: admin
    PARENTTASKstring
    Example:
    PROVISIONINGCOMMENTSstring
    Example:
    PROVISIONINGMETADATAstring
    Example:
    REQUESTACCESSKEYstring
    Example:
    REQUESTIDstring
    Example:
    REQUESTKEYstring
    Example:
    SECURITYSYSTEMstring
    Example: Active Directory Plus
    STARTDATEstring
    Example:
    STATUSstring
    Example: New
    TASKIDstring
    Example: 10642653
    TASKTYPEstring
    Example: Change Password
    UPDATEDATEstring
    Example: 2021-01-04 20:27:34
    USERstring
    Example: bsimpson5
    upadteuserstring
    Example: bsimpson5(2021-01-04 20:27:34)

  • ]

    • totalrecordsstring
    Example: 2
    totaltasksstring
    Example: 2