v3

latestSwagger 2.02026-08-067506752.0 MB

role

Return a particular role by id

get/v1/org/{orgId}/role/{roleId}

orgIdstring required

Org identifier (either id or slug)

roleIdstring required

Role id

expandboolean

(Optional) Expand the role's policies and full user list.

successful operation

idstring required

globally unique id

orgIdstring

parent organization id (empty if global)

labelstring required

human-readable full name of role

descriptionstring

description of role

policyIdsstring[]

the policies that define the role

userCountinteger

number of users the role is attached to; populated when expand=true on the list endpoint

createIdstring

created by user id

createAtstring

created timestamp

updateIdstring

last updated by user id

updateAtstring

last updated timestamp

deleteIdstring

deleted by user id

deleteAtstring

deleted timestamp