REST API for Oracle Identity Governance Self Service

Update requests

put

/iam/governance/selfservice/api/v1/requests

Updates request(s). The Oracle Identity Manager request ID should be specified in the payload along with the update details to update the request. The request data can updated or the request status can be updated. Based on the Type of action attribute provided the SOA or OIM action is executed. Here the Action's could be APPROVE,RELEASE, RESUME, REASSIGN, REJECT, ESCALATE, SUSPEND, WITHDRAW, CLAIM, SAVE, CREATESUBTASK, SKIPASSIGNMENT . Addition to these we have one additions operation of CLOSE, which can be performed on the Requests. An Additional TaskId can be provided with the request to exclusively perform operation on the specific task. If the taskId is not provided then the first task in the list will be picked for the operation requested on the requestId.

Request

Supported Media Types

application/json

List of update attributes for updating requests

Root Schema : BulkReqUpdateRequest

Type: object

Show Source

requests(optional): array requests

{
    "properties":{
        "requests":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/ReqUpdateRequestEntity"
            }
        }
    }
}

Nested Schema : requests

Type: array

Show Source

[0]: object ReqUpdateRequestEntity

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/ReqUpdateRequestEntity"
    }
}

Nested Schema : ReqUpdateRequestEntity

Type: object

Show Source

action(optional): string
actionComment(optional): string
assignees(optional): array assignees
id(optional): string
reqTargetEntities(optional): array reqTargetEntities
requestId(optional): string
taskId(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "action":{
            "type":"string"
        },
        "actionComment":{
            "type":"string"
        },
        "id":{
            "type":"string"
        },
        "taskId":{
            "type":"string"
        },
        "assignees":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/PendingApprovalsAssigneeNames"
            }
        },
        "reqTargetEntities":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/reqTargetEntityRequestPayload"
            }
        }
    }
}

Nested Schema : assignees

Type: array

Show Source

[0]: object PendingApprovalsAssigneeNames

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PendingApprovalsAssigneeNames"
    }
}

Nested Schema : reqTargetEntities

Type: array

Show Source

[0]: object reqTargetEntityRequestPayload

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/reqTargetEntityRequestPayload"
    }
}

Nested Schema : PendingApprovalsAssigneeNames

Type: object

Show Source

name(optional): string
type(optional): string

{
    "properties":{
        "name":{
            "type":"string"
        },
        "type":{
            "type":"string"
        }
    }
}

Nested Schema : reqTargetEntityRequestPayload

Type: object

Show Source

appFormData(optional): array appFormData
catalogId(optional): string
entityId(optional): string
entityName(optional): string
entityType(optional): string
parentAccountId(optional): integer
parentAccountName(optional): string

{
    "properties":{
        "entityName":{
            "type":"string"
        },
        "entityId":{
            "type":"string"
        },
        "catalogId":{
            "type":"string"
        },
        "entityType":{
            "type":"string"
        },
        "parentAccountId":{
            "type":"integer"
        },
        "parentAccountName":{
            "type":"string"
        },
        "appFormData":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Fields"
            }
        }
    }
}

Nested Schema : appFormData

Type: array

Show Source

[0]: object Fields

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Fields"
    }
}

Nested Schema : Fields

Type: object

Show Source

name(optional): string
value(optional): string

{
    "properties":{
        "name":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : BulkReqUpdateResponse

Type: object

Show Source

requests(optional): array requests

{
    "properties":{
        "requests":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/ReqUpdateResponseEntity"
            }
        }
    }
}

Nested Schema : requests

Type: array

Show Source

[0]: object ReqUpdateResponseEntity

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/ReqUpdateResponseEntity"
    }
}

Nested Schema : ReqUpdateResponseEntity

Type: object

Show Source

id(optional): string
links(optional): array links
reason(optional): string
requestId(optional): string
status(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "id":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "reason":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkDataInstances"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

[0]: object LinkDataInstances

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LinkDataInstances"
    }
}

Nested Schema : LinkDataInstances

Type: object

Show Source

href(optional): string
rel(optional): string

{
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

403 Response

Forbidden

404 Response

Resource not found

500 Response

Internal Server Error