latestOpenAPI 3.1.02026-08-221163801019.2 KB

f0f28319e448

Role

Get roles

Return a list of roles in this organization.

Permissions

This endpoint may be impacted by the following permissions:

  • Only roles that the authenticated user has the Role:GetRole permission on will be returned.
get/v1/{organization}/role/

Path parameters

organizationstring required

Query parameters

return_permission_grantsboolean

Whether to return permission grants.

Whether to return permission grants.

idstring[]

The IDs of the roles to retrieve.

The IDs of the roles to retrieve.

namestring[]

The names of the roles to retrieve.

The names of the roles to retrieve.

Headers

x-mongo-cluster-namestring nullable

The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.

The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.

Sec-WebSocket-Protocolstring[]

Response

Succeeded