Skip to main content

List My Permissions

GET https://infrahub-api.nexgencloud.com/v1/auth/users/me/permissions​

Returns a list of permissions granted to your account, enabling access to specific resource actions.


Parameters​

No parameters.


Attributes​

status boolean​

Indicates the status of the request to retrieve a list of your permissions, true indicates success, while false indicates error.

message string​

A message describing the status of the request.

permissions array of objects​

An array of objects containing information about permissions that are granted to your account.

Show child attributes

resource string​

The resource to which the permission grants access (e.g., environment, virtual machine, volume).

permission string​

The permission name, in this case, environment:list, indicates that when granted to a user, it permits the "list" action for the environment resource.

id integer​

The unique identifier for the permission.


Example request
curl -X GET "https://infrahub-api.nexgencloud.com/v1/auth/users/me/permissions" \
 -H "accept: application/json"\
 -H "api_key: YOUR API KEY"
Response
{
    "status": true,
    "message": "Getting my permissions successfully",
    "permissions": [
        {
            "resource": "Environment",
            "permission": "environment:list",
            "id": 1
        },
        {...}
    ]
}

Returns​

The response will include the status of the request along with an array of permissions objects, each containing details about permissions granted to your account. Within the permissions objects, you'll find information such as the permission name, ID, and the resource action to which the permission grants access.



Back to top​