GET/api/me/organizations/{organization_id}/roleAuthenticated

Get my role in an organization

Returns the caller's membership role in one organization; 404 when the caller is not a member (platform administrators hold the virtual admin role in the owner organization).

operationId get_api_me_organizations_organization_id_roleAccount

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

Path parameters

Name	Type	Description
organization_id*	string	Organization id (URL-safe slug)

Responses

application/json

Property	Type	Description
success*	true
message*	string
data*	object
organization_id*	string	minLength: 4maxLength: 32pattern: ^[a-z][a-z0-9_-]+$
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"

"organization_id""string"

"role""member"

Example request

bashcurl

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

Authentication & permissionsAuthenticated

Path parameters

Responses

200The caller'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 caller is not a member of the organization

500Failed to look up the membership

Example request