Get your capabilities
GET /auth/me/capabilities
Returns the capabilities your account holds across the whole instance, with one of your global roles and the grants and revokes recorded on your account. Any signed-in account can call it.
role is one of your global roles, the first by name if you have
several; it’s left out if you have none. capabilities includes
what all your global roles give you, not only the one in role.
Roles you hold within a team aren’t shown here, and neither are the
capabilities they give you.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Your capabilities, role, grants and revokes.
object
object
The role this one inherits from. Left out if it has no parent.
Capability codes attached directly to this role. Capabilities it
inherits through parent_id aren’t included.
The capabilities your account holds across the instance: what all
your global roles and the roles they inherit from give you, plus
global grants, minus global revokes. Capabilities that apply only
within a team aren’t included. system.admin counts as every other
capability, except ones that need a license feature this instance
doesn’t have.
If your capabilities can’t be loaded, this list comes back empty, so an empty list doesn’t always mean you have none.
Capability codes granted to your account directly. Grants that apply within a team are included too, without the team.
Capability codes revoked from your account directly. Revokes that apply within a team are included too, without the team.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}