Get system roles

GET 
/system_roles

This endpoint can retrieve system roles from NERM. Optionally you can provide parameters to filter results.

Request

Query Parameters

query object

Allows for pagination and sorting.

metadata boolean

Returns batching metadata in the response

Responses

200

Expected response to a valid request

application/json

Schema

Schema

system_roles

object[]

Array [

id uuid

The unique identifier for the object

uid string

Possible values: >= 32 characters and <= 32 characters, [profile_contributor, profile_owner]

The user identifier for the object

name string

Possible values: [Profile Contributor, Profile Owner]

The name of the role

]

_metadata

object

limit integer

offset integer

total integer

next string

previous string

Example (from schema)

{
  "system_roles": [
    {
      "id": "2e06b876-f456-473d-bd65-b6435e0b6b2d",
      "uid": "profile_contributor",
      "name": "Profile Contributor"
    }
  ],
  "_metadata": {
    "limit": 0,
    "offset": 0,
    "total": 0,
    "next": "/endpoint?limit=10&offset=60",
    "previous": "/endpoint?limit=10&offset=40"
  }
}

400

Bad Request - unable to complete.

application/json

Schema

Schema

oneOf

InvalidJson

error

ValidationErrors

error

errors

Example (from schema)

{}

500

Internal Server Error - returned on unhandled exceptions.

application/json

Schema

Schema

error

A message describing the error

Example (from schema)

{
  "error": "Sorry something went wrong"
}

Loading...