GET/api/organizations/{organization_id}/members/{uid}/roleAuthenticated

Get a member's role

Returns the role one user holds in the organization. Members of the organization and platform administrators may call it.

operationId get_api_organizations_organization_id_members_uid_roleOrganizations

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials: Auth server session (refresh token cookie)cookie "refresh_token_<auth_server_app_id>"
Access token (cookie)cookie "access_token_<auth_server_app_id>"
Access token (Bearer)Authorization: Bearer <JWT>
Who may call: Any authenticated user
Notes: The caller must be a member of the organization or a platform administrator.

Path parameters

Name	Type	Description
organization_id*	string	Organization id (URL-safe slug)
uid*	string (uuid)	User id of the member

Responses

application/json

Property	Type	Description
success*	true
message*	string
data*	object
role*	string	Membership role in the organization: `owner`, `member`, or `admin` (the virtual role platform administrators hold in the owner organization).

JSONExample

"success"true

"message""string"

"data"

"role""member"

Example request

bashcurl

curl -X GET 'https://auth.schemavaults.com/api/organizations/<organization_id>/members/<uid>/role' \
  -b 'refresh_token_<auth_server_app_id>=<value>'

Other methods on this path

PATCHChange a member's role

Authentication & permissionsAuthenticated

Path parameters

Responses

200The member's role

400The request failed validation (issues lists the offending fields) or was refused by the handler

401No valid session cookie, access token cookie or bearer access token was presented, or the token was revoked

403The account is disabled, or the credential is valid but not allowed to perform this operation

404The user is not a member of the organization

Example request

Other methods on this path