GET rbac/roles/:role id

From Social ID Developers
Jump to: navigation, search

Contents

Description

Returns a Role.

Resource URL

  GET https://api.socialidnow.com/v1/rbac/roles/:role_id

Parameters

URL Parameters

role_id required role identifier.

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 role.
internal_server_error (500) An unknown error happened.

Response Body

The following fields are returned:

id role identifier.
name role name.
login_app_id application identifier.
description role description.
created_at date of role creation.
updated_at date of role latest update.

Examples

Request

curl -X GET 'https://api.socialidnow.com/v1/rbac/roles/1' \
  --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf

Response

Response Headers

HTTP/1.1 200 Ok
Status: 200

Response Body

{
  "id": 1,
  "name": "role A",
  "login_app_id": 100,
  "description": "My role A description",
  "created_at": "2022-11-17T21:30:00Z",
  "updated_at": "2022-11-17T21:30:00Z"
}
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox