Oracle Access Governance REST APIs

Get list of event changes for an access review

get

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/eventChanges

Returns list of event changes of the access review for a given accessReviewId.

Request

Path Parameters

accessReviewId(required): string

Unique access review identifier.

Query Parameters

limit: integer

Minimum Value: 1

Maximum Value: 1000

The maximum number of items to return.

Default Value: 10
page: string

Minimum Length: 1

A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
sortBy: string

The sort by parameter for event changes and default value is displayName.

Default Value: displayName

Allowed Values: [ "id", "displayName", "timeChanged" ]
sortOrder: string

The sort order to use, either 'ASC' or 'DESC'.

Allowed Values: [ "ASC", "DESC" ]

Header Parameters

opc-request-id: string

The client request ID for tracing. The only valid characters for request IDs are letters, numbers, underscore, and dash.

Response

Supported Media Types

application/json

200 Response

The access review event changes.

Headers

opc-next-page: string

For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items.
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 : AccessReviewEventChangesSummaryCollection

Type: object

List of event change summaries.

Show Source

items(required): array items

List of event change summaries.

{
    "type":"object",
    "description":"List of event change summaries.",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of event change summaries.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/AccessReviewEventChangesSummary"
            }
        }
    }
}

Nested Schema : items

Type: array

List of event change summaries.

Show Source

Array of: object AccessReviewEventChangesSummary

The event change associated with the given review task.

{
    "description":"List of event change summaries.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/AccessReviewEventChangesSummary"
    }
}

Nested Schema : AccessReviewEventChangesSummary

Type: object

The event change associated with the given review task.

Show Source

currentValue: string

The current value.
displayName(required): string

The display name of the event change.
format: string

The format of the value.
id(required): string

The id of the event change.
previousValue: string

The previous value.
sourceType(required): string

Allowed Values: [ "GLOBAL_IDENTITY", "OIG", "OCI", "ICF", "TARGET_IDENTITY", "AGCS" ]

The source type of the event change.
timeChanged: string(date-time)

The date that event change occurred.

{
    "type":"object",
    "description":"The event change associated with the given review task.",
    "required":[
        "id",
        "displayName",
        "sourceType"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The id of the event change."
        },
        "displayName":{
            "description":"The display name of the event change.",
            "type":"string"
        },
        "sourceType":{
            "description":"The source type of the event change.",
            "type":"string",
            "x-obmcs-top-level-enum":"#/definitions/SourceType",
            "enum":[
                "GLOBAL_IDENTITY",
                "OIG",
                "OCI",
                "ICF",
                "TARGET_IDENTITY",
                "AGCS"
            ]
        },
        "timeChanged":{
            "description":"The date that event change occurred.",
            "type":"string",
            "format":"date-time"
        },
        "previousValue":{
            "type":"string",
            "description":"The previous value."
        },
        "currentValue":{
            "type":"string",
            "description":"The current value."
        },
        "format":{
            "type":"string",
            "description":"The format of the value."
        }
    }
}

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."
}

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 retrieve recent event changes for an access review task. The Recent Changes Log tracks identity attribute changes that are enabled in the Event-based Setup. Replace placeholder values with actual values before running the sample command.

cURL Example - Without Query Parameters

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-reviews/accessReviews/${accessReviewId}/eventChanges'

Example of the Response Body

The following example shows the contents of the response body in JSON format:

{
  "items": [
    {
      "id": "e22fb1ef-8413-4026-a879-e4c3db38682e",
      "displayName": "Manager",
      "sourceType": "GLOBAL_IDENTITY",
      "timeChanged": "2024-12-12T11:14:06.445Z",
      "previousValue": null,
      "currentValue": "HOWARD.FLOWERS",
      "format": null
    },
    {
      "id": "c9d9b67c-0095-40f7-8bba-213cc4a62e46",
      "displayName": "DateOfJoining",
      "sourceType": "GLOBAL_IDENTITY",
      "timeChanged": "2024-12-12T11:14:00.669Z",
      "previousValue": null,
      "currentValue": "1457049600000",
      "format": "date-time"
    },
    {
      "id": "fe4922b3-8983-4f33-ab95-0a444ad3ff25",
      "displayName": "Location",
      "sourceType": "GLOBAL_IDENTITY",
      "timeChanged": "2024-12-12T11:14:00.669Z",
      "previousValue": null,
      "currentValue": "France",
      "format": null
    },
    {
      "id": "1263e9f1-1077-4944-a26b-ac3aa9906987",
      "displayName": "Source organization value",
      "sourceType": "GLOBAL_IDENTITY",
      "timeChanged": "2024-12-12T11:14:00.668Z",
      "previousValue": null,
      "currentValue": "Finance",
      "format": null
    },
    {
      "id": "8303dd7e-f71b-41a4-ac87-4af64023eee1",
      "displayName": "Job code",
      "sourceType": "GLOBAL_IDENTITY",
      "timeChanged": "2024-12-12T11:14:00.668Z",
      "previousValue": null,
      "currentValue": "IC005",
      "format": null
    }
  ]
}