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

Description

Searches for Events in an Access Request.

An event is either a Comment or a Review.

Resource URL

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

Parameters

URL Parameters

access_request_id	required	access request identifier.
actor_type	optional	actor type. Possible values: "login_user" or "custom".
actor_id	optional	actor identifier.
ids	optional	comma separated list of event 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 events found.
offset	amount of discarded access request events (page start).
count	amount of access request events returned in this page.
results	array with access request events details:
id	access request event identifier.
access_request_id	access request identifier.
type	event type. Possible values: "comment" or "review".
actor_type	type of the actor performing the event. Possible values: "login_user" or "custom".
actor_id	actor identifier.
comment	comment.
created_at	date of access request event creation.
updated_at	date of access request event latest update.
status	review status. Possible values: "approved" or "rejected". Note: Only returned when event type is "review".

Examples

Without search parameters

Request

curl -iX GET 'https://api.socialidnow.com/v1/rbac/access_requests/10/events' \
  --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,
      "type": "comment",
      "actor_type": "login_user",
      "actor_id": "100",
      "comment": "First Access Request Event comment",
      "created_at": "2023-08-10T21:07:00Z",
      "updated_at": "2023-08-10T21:07:00Z"
    },
    {
      "id": 2,
      "access_request_id": 10,
      "type": "review",
      "actor_type": "login_user",
      "actor_id": "200",
      "comment": "Second Access Request Event comment",
      "created_at": "2023-08-10T21:08:00Z",
      "updated_at": "2023-08-10T21:08:00Z",
      "status": "approved"
    },
    {
      "id": 3,
      "access_request_id": 10,
      "type": "review",
      "actor_type": "custom",
      "actor_id": "admin",
      "comment": "",
      "created_at": "2023-08-10T21:09:00Z",
      "updated_at": "2023-08-10T21:09:00Z",
      "status": "rejected"
    }
  ]
}

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,
      "type": "review",
      "actor_type": "login_user",
      "actor_id": "200",
      "comment": "Second Access Request Event comment",
      "created_at": "2023-08-10T21:08:00Z",
      "updated_at": "2023-08-10T21:08:00Z",
      "status": "approved"
    }
  ]
}