Welcome to the New BigPanda API Documentation

Retrieve All Roles

US Region

https://api.bigpanda.io

GET

/resources/v2.1/roles

The Roles API is a tool to help you manage user roles in the BigPanda system, enabling you to bulk manage even large and complex permissions.

Use the Roles API to create, retrieve, update, and delete roles from the BigPanda UI.

Authentication

All BigPanda APIs require Bearer Token Authorization in the call headers.
This API uses the User API Key type of Authorization token. Your User API Key must be provided in the header, prefixed by the word Bearer.

Example:
Authorization: Bearer [YOUR_USER_API_KEY]

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

200

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.bigpanda.io/resources/v2.1/roles?page=&per_page=&direction=&sort=' \
--header 'Authorization: Bearer <token>'

Response Example

[
    {
        "name": "Admin",
        "id": "role-id-123",
        "users": [
            "60c5238222fa63633d935555",
            "5555238222fa63633d93560c"
        ],
        "created_by": "user-id-123",
        "created_at": 1620000000,
        "updated_at": 1620500000,
        "permissions": [
            {
                "resource_type": "environments",
                "resource_id": "624e114fb4d7581100179111",
                "actions": "read"
            }
        ]
    }
]

Modified at 2026-09-04 16:33:43

Retrieve Role by ID

Update Role

Retrieve All Roles

Authentication#

Request

Responses

Authentication