V2 APIUsers
Get role
GET
/api/v2/roles/{role}Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
role*string
Format
uuidQuery Parameters
account_id?string
Optional account to run this request against. Defaults to the account the API token is scoped to, so callers with a single account can omit it. Must be an account the authenticated user belongs to; staff may target any account. For write requests the value may be sent in the JSON body instead of the query string. The resolved account is returned on the X-Resi-Account-Id response header.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/roles/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "key": "string", "name": "string", "slug": "string", "system_key": "string", "is_default": true, "is_protected": true, "permissions": { "property1": [ "string" ], "property2": [ "string" ] }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }}