Welcome to the New BigPanda API Documentation

Update User Roles

US Region

https://api.biggy.io

PATCH

/users/{userId}/roles

Adjust a user's role assignments. Supports adding, removing, or
replacing roles.

set replaces the entire role list. add appends without duplicates. remove removes the specified roles.

If all roles are removed, the Standard User role is automatically assigned as a fallback.

All roleIds must belong to valid roles within your organization.

🚧 Authentication
All BigPanda APIs require Bearer Token Authorization in the call headers.
This API uses the User API Key type of Authorization token.

📘 Required permissions
Your account must have the User Management permission set to Edit to use this endpoint.

❗ Rate limitations
To maintain quality of service, the Biggy API is limited to 100 requests per minute. Additional requests will return a 429 response code and the request will need to be retried.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.biggy.io/users//roles' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "action": "add",
    "roleIds": "65f0c8f8d73b2b0012ab1123"
}'

Response Example

200 - Success

{
    "user": {
        "id": "65f0c8f8d73b2b0012ab3456",
        "fullName": "Jane Doe",
        "email": "jane@example.com",
        "roles": [
            "65f0c8f8d73b2b0012ab1111",
            "65f0c8f8d73b2b0012ab2222"
        ]
    },
    "roles": [
        {
            "id": "65f0c8f8d73b2b0012ab1111",
            "name": "System Admin",
            "type": "system",
            "permissions": []
        },
        {
            "id": "65f0c8f8d73b2b0012ab2222",
            "name": "Analyst",
            "type": "organization",
            "permissions": []
        }
    ]
}

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

Retrieve User Roles

Roles