List the items of an access review.

GET

/api/admin/compliance/access-reviews/{id}/items

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/compliance/access-reviews/example/items?decision=pending&limit=50' \
  --header 'Authorization: Bearer <token>'

Lists the review’s items with the user’s current name and email (not copied into the review), their decisions and how each revocation was applied.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Access review id.

Query Parameters

decision

string

Allowed values: pending approved revoked

limit

integer

default: 50 >= 1 <= 100

cursor

string

Responses

200

A page of items.

Media type application/json

object

data

required

Array<object>

object

item_id

required

string

user_id

required

string

user

required

object

email

string | null

name

string | null

permission_type

required

string

Allowed values: role organization account

permission_value

required

string

decision

required

string | null

Allowed values: approved revoked

decided_by

string | null

decided_at

string | null format: date-time

justification

string | null

apply_status

Applying (being applied), applied (done, or the access was already gone), incomplete (started and not finished; completing again finishes it and its decision no longer changes, even if that admin may not apply it), failed (refused before anything changed: permission, hierarchy, or a newer status change of the account, lifecycle_superseded; it can be decided again), skipped (approved).

string | null

Allowed values: applying applied incomplete failed skipped

applied_at

string | null format: date-time

apply_error

string | null

pagination

required

object

has_more

required

boolean

next_cursor

string

key

additional properties

Example

{
  "data": [
    {
      "permission_type": "role",
      "decision": "approved",
      "apply_status": "applying"
    }
  ]
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}