Get User Role
GET /roles/users/{user_id}
The role one person holds in this organisation.
404 when they hold none - which is a real state, not an error: a member can exist in the organisation with no role assigned yet.
The WRITE twin, PUT /v1/roles/users/{user_id}, is not published. It
maps a role slug of owner or admin onto the identity provider’s own
Owner/Admin and syncs it, so it can make somebody an administrator of the
tenant.
Authorizations
Parameters
Path Parameters
Identity-provider user id.
Identity-provider user id.
Header Parameters
Responses
200
Successful Response
object
An open envelope for a single role, team, member or account record.
Open on purpose. The app’s own response models on this surface grow with
the product - RoleResponse gained rep_limits and manages_role_slugs,
TeamResponse gained channel counts and a campaign count - and a pinned
mirror would SILENTLY DROP whatever it had not caught up on. A dropped
permission in a role read is the worst possible kind of stale: it reads as
“they do not have it”.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error