GET rbac/access requests/:access request id/reviews

Description

Searches for Reviews in an Access Request.

Resource URL

  GET https://api.socialidnow.com/v1/rbac/access_requests/:access_request_id/reviews

Parameters

URL Parameters

access_request_id	required	access request identifier.
status	optional	review status. Possible values: "approved" or "rejected".
actor_type	optional	actor type. Possible values: "login_user" or "custom".
actor_id	optional	actor identifier.
ids	optional	comma separated list of review ids. Example: ids=1,2,3.
page	optional	page number (each page contains page_size results). Default: 1.
page_size	optional	maximum amount of results to be returned. Default: 8.

Authentication

This API requires Account authentication. See Authentication.

Response

Response Status

ok (200)	The request was successful.
unauthorized (401)	The authentication is wrong. See Authentication.
forbidden (403)	The account does not have access to this access request.
internal_server_error (500)	An unknown error happened.

Response Body

A successful search returns the following fields:

total	total amount of access request reviews found.
offset	amount of discarded access request reviews (page start).
count	amount of access request reviews returned in this page.
results	array with access request reviews details:
id	access request review identifier.
access_request_id	access request identifier.
actor_type	type of the actor performing the review. Possible values: "login_user" or "custom".
actor_id	actor identifier.
status	review status. Possible values: "approved" or "rejected".
comment	comment.
created_at	date of access request review creation.
updated_at	date of access request review latest update.

Examples

Without search parameters

Request

curl -iX GET 'https://api.socialidnow.com/v1/rbac/access_requests/10/reviews' \
  --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf

Response

Response Headers

HTTP/1.1 200 Ok
Status: 200

Response Body

{
  "total": 3,
  "offset": 0,
  "count": 3,
  "results": [
    {
      "id": 1,
      "access_request_id": 10,
      "actor_type": "login_user",
      "actor_id": "100",
      "status": "approved",
      "comment": "First Access Request Review comment",
      "created_at": "2023-08-10T20:56:00Z",
      "updated_at": "2023-08-10T20:56:00Z"
    },
    {
      "id": 2,
      "access_request_id": 10,
      "actor_type": "login_user",
      "actor_id": "200",
      "status": "approved",
      "comment": "Second Access Request Review comment",
      "created_at": "2023-08-10T20:57:00Z",
      "updated_at": "2023-08-10T20:57:00Z"
    },
    {
      "id": 3,
      "access_request_id": 10,
      "actor_type": "custom",
      "actor_id": "admin",
      "status": "rejected",
      "comment": "",
      "created_at": "2023-08-10T20:58:00Z",
      "updated_at": "2023-08-10T20:58:00Z"
    }
  ]
}

With search parameters

Request

curl -iX GET 'https://api.socialidnow.com/v1/rbac/access_requests/10/reviews?page_size=1&page=2' \
  --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf

Response

Response Headers

HTTP/1.1 200 Ok
Status: 200

Response Body

{
  "total": 3,
  "offset": 1,
  "count": 1,
  "results": [
    {
      "id": 2,
      "access_request_id": 10,
      "actor_type": "login_user",
      "actor_id": "200",
      "status": "approved",
      "comment": "Second Access Request Review comment",
      "created_at": "2023-08-10T20:57:00Z",
      "updated_at": "2023-08-10T20:57:00Z"
    }
  ]
}