Oracle Access Governance REST APIs

Check status of the separation of duties request(s)

post

/access-governance/access-controls/20250331/separationOfDuties/actions/status

Returns the current status for one or more separation of duties requests.

Request

Header Parameters

if-match: string

For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
opc-request-id: string

The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.
opc-retry-token: string

Minimum Length: 1

Maximum Length: 64

A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request might be rejected.

Separation of duties request IDs.

Root Schema : CheckSeparationOfDutiesStatusDetails

Type: object

Separation of duties analysis request IDs.

Show Source

requestIds(required): array requestIds

List of separation of duties request IDs.

{
    "type":"object",
    "required":[
        "requestIds"
    ],
    "properties":{
        "requestIds":{
            "type":"array",
            "description":"List of separation of duties request IDs.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Separation of duties analysis request IDs."
}

Nested Schema : requestIds

Type: array

List of separation of duties request IDs.

Show Source

Array of: string

{
    "type":"array",
    "description":"List of separation of duties request IDs.",
    "items":{
        "type":"string"
    }
}

Response

Supported Media Types

application/json

200 Response

Separation of duties request statuses.

Headers

etag: string

For optimistic concurrency control. See `if-match`.
opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : SeparationOfDutiesStatusResponse

Type: object

Current status of one or more separation of duties requests.

Show Source

items(required): array items

List of request status.

{
    "type":"object",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "type":"array",
            "description":"List of request status.",
            "items":{
                "$ref":"#/definitions/SeparationOfDutiesStatus"
            }
        }
    },
    "description":"Current status of one or more separation of duties requests."
}

Nested Schema : items

Type: array

List of request status.

Show Source

Array of: object SeparationOfDutiesStatus

Separation of Duties status.

{
    "type":"array",
    "description":"List of request status.",
    "items":{
        "$ref":"#/definitions/SeparationOfDutiesStatus"
    }
}

Nested Schema : SeparationOfDutiesStatus

Type: object

Separation of Duties status.

Show Source

requestedBy(required): string

Requested by.
requestId(required): string

Unique identifier that is immutable on creation.
requestStatus(required): string

Allowed Values: [ "SUCCESS", "FAILED", "IN_PROGRESS" ]

Request status.
sodEvents(required): array sodEvents

One or more separation of duties events.
timeRequestCompletion: string(date-time)

Request completion time.
timeRequested: string(date-time)

Request time.

{
    "type":"object",
    "required":[
        "requestId",
        "requestStatus",
        "requestedBy",
        "sodEvents"
    ],
    "properties":{
        "requestId":{
            "type":"string",
            "description":"Unique identifier that is immutable on creation."
        },
        "requestStatus":{
            "type":"string",
            "description":"Request status.",
            "enum":[
                "SUCCESS",
                "FAILED",
                "IN_PROGRESS"
            ],
            "x-obmcs-top-level-enum":"#/definitions/SeparationOfDutiesRequestStatus"
        },
        "timeRequested":{
            "type":"string",
            "format":"date-time",
            "description":"Request time."
        },
        "timeRequestCompletion":{
            "type":"string",
            "format":"date-time",
            "description":"Request completion time."
        },
        "requestedBy":{
            "type":"string",
            "description":"Requested by."
        },
        "sodEvents":{
            "type":"array",
            "description":"One or more separation of duties events.",
            "items":{
                "$ref":"#/definitions/SeparationOfDutiesEvent"
            }
        }
    },
    "description":"Separation of Duties status."
}

Nested Schema : sodEvents

Type: array

One or more separation of duties events.

Show Source

Array of: object SeparationOfDutiesEvent

Separation of Duties Event.

{
    "type":"array",
    "description":"One or more separation of duties events.",
    "items":{
        "$ref":"#/definitions/SeparationOfDutiesEvent"
    }
}

Nested Schema : SeparationOfDutiesEvent

Type: object

Separation of Duties Event.

Show Source

createdBy(required): string

Created by.
hasConflict(required): boolean

Has conflict.
id(required): string

Unique identifier that is immutable on creation.
provider(required): string

Separation of duties provider.
status(required): string

Allowed Values: [ "SUCCESS", "FAILED", "IN_PROGRESS", "PENDING", "PENDING_DEPENDENT" ]

Separation of duties event status.
timeCreated: string(date-time)

Create time.
timeProcessingEnded: string(date-time)

Processing end time.
timeProcessingStarted: string(date-time)

Processing start time.
violations(required): array violations

A list of zero or more violations.

{
    "type":"object",
    "required":[
        "createdBy",
        "hasConflict",
        "id",
        "provider",
        "status",
        "violations"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier that is immutable on creation."
        },
        "status":{
            "type":"string",
            "description":"Separation of duties event status.",
            "enum":[
                "SUCCESS",
                "FAILED",
                "IN_PROGRESS",
                "PENDING",
                "PENDING_DEPENDENT"
            ],
            "x-obmcs-top-level-enum":"#/definitions/SeparationOfDutiesEventStatus"
        },
        "createdBy":{
            "type":"string",
            "description":"Created by."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"Create time."
        },
        "timeProcessingStarted":{
            "type":"string",
            "format":"date-time",
            "description":"Processing start time."
        },
        "timeProcessingEnded":{
            "type":"string",
            "format":"date-time",
            "description":"Processing end time."
        },
        "hasConflict":{
            "type":"boolean",
            "description":"Has conflict."
        },
        "provider":{
            "type":"string",
            "description":"Separation of duties provider."
        },
        "violations":{
            "type":"array",
            "description":"A list of zero or more violations.",
            "items":{
                "$ref":"#/definitions/SeparationOfDutiesViolationSummary"
            }
        }
    },
    "description":"Separation of Duties Event."
}

Nested Schema : violations

Type: array

A list of zero or more violations.

Show Source

Array of: object SeparationOfDutiesViolationSummary

Summary of a single separation of duties violation.

{
    "type":"array",
    "description":"A list of zero or more violations.",
    "items":{
        "$ref":"#/definitions/SeparationOfDutiesViolationSummary"
    }
}

Nested Schema : SeparationOfDutiesViolationSummary

Type: object

Summary of a single separation of duties violation.

Show Source

controlName(required): string

The control name of the violation.
violation(required): array violation

A list of one or more violation details.

{
    "type":"object",
    "required":[
        "controlName",
        "violation"
    ],
    "properties":{
        "controlName":{
            "type":"string",
            "description":"The control name of the violation."
        },
        "violation":{
            "type":"array",
            "description":"A list of one or more violation details.",
            "items":{
                "$ref":"#/definitions/SeparationOfDutiesViolationDetail"
            }
        }
    },
    "description":"Summary of a single separation of duties violation."
}

Nested Schema : violation

Type: array

A list of one or more violation details.

Show Source

Array of: object SeparationOfDutiesViolationDetail

Detail of a single separation of duties violation.

{
    "type":"array",
    "description":"A list of one or more violation details.",
    "items":{
        "$ref":"#/definitions/SeparationOfDutiesViolationDetail"
    }
}

Nested Schema : SeparationOfDutiesViolationDetail

Type: object

Detail of a single separation of duties violation.

Show Source

accessPoint(required): string

The name of the access point.
conflictingRole(required): string

The name of the conflicting role.

{
    "type":"object",
    "required":[
        "accessPoint",
        "conflictingRole"
    ],
    "properties":{
        "conflictingRole":{
            "type":"string",
            "description":"The name of the conflicting role."
        },
        "accessPoint":{
            "type":"string",
            "description":"The name of the access point."
        }
    },
    "description":"Detail of a single separation of duties violation."
}

400 Response

Bad Request

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

401 Response

Unauthorized

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

404 Response

Not Found

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

409 Response

Conflict

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

412 Response

Precondition failed

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

429 Response

Too Many Requests

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

500 Response

Internal Server Error

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

Default Response

Unknown Error

Headers

opc-request-id: string

Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Root Schema : Error

Type: object

Error Information.

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing.
message(required): string

A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

Examples

The following example shows how to check status of SoD flagged requests.

cURL Request Example

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
    "requestIds": [
        "001673a9955b43fc97aedcdxxx71e14f2",
        "f334fbba4e1b41b1a2fc21345xxd73e729"
    ]
}'\
 '<${service-instance-url}/access-governance/access-controls/${versionId}/separationOfDuties/actions/status>'

Example Request Payload

{
    "requestIds": [
        "001673a9955b43fc97aedcdxxx71e14f2",
        "f334fbba4e1b41b1a2fc21345xxd73e729"
    ]
}

Example of the Response Code

You'll receive 200 OK response along with the following response body:

{
    "items": [
        {
            "requestId": "001673a9955b43fc97aedc93571e14f2",
            "requestStatus": "SUCCESS",
            "timeRequested": "2025-11-12T16:51:55.000Z",
            "timeRequestCompletion": "2025-11-12T16:55:01.227Z",
            "requestedBy": "88b9690ece344653953570480031e7d0",
            "sodEvents": [
                {
                    "id": "b582216225204201b011a09d59df46e0",
                    "status": "SUCCESS",
                    "createdBy": "88b9690ece344653953570480031e7d0",
                    "timeCreated": "2025-11-12T16:51:55.000Z",
                    "timeProcessingStarted": "2025-11-12T16:51:57.282Z",
                    "timeProcessingEnded": "2025-11-12T16:55:01.227Z",
                    "hasConflict": true,
                    "provider": "FA_RMCS",
                    "violations": [
                        {
                            "controlName": "10103: Sensitive Joint Venture Stakeholder Privileges",
                            "violation": [
                                {
                                    "conflictingRole": "Application Implementation Consultant",
                                    "accessPoint": "Manage Joint Venture Definition"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "requestId": "f334fbba4e1b41b1a2fc2135cd73e729",
            "requestStatus": "FAILED",
            "timeRequested": "2025-11-12T16:51:57.000Z",
            "timeRequestCompletion": "2025-11-12T16:52:37.853Z",
            "requestedBy": "88b9690ece344653953570480031e7d0",
            "sodEvents": [
                {
                    "id": "20b2884487674888960c83320212bdd2",
                    "status": "FAILED",
                    "createdBy": "88b9690ece344653953570480031e7d0",
                    "timeCreated": "2025-11-12T16:51:57.000Z",
                    "timeProcessingStarted": "2025-11-12T16:52:18.772Z",
                    "timeProcessingEnded": "2025-11-12T16:52:37.853Z",
                    "hasConflict": false,
                    "provider": "FA_RMCS",
                    "violations": []
                }
            ]
        }
    ]
}