Revoke Multiple Permissions on a Team

DELETE

/api/v2/teams/{team_id}/permissions/batch

Removes the roles of several users on a team in one call. Each item is applied on its own, in
order: an item that fails doesn't stop the others, and the items already applied stay applied.

The response is 200 even when every item fails; read data.failed to find the items that
weren't applied. Each item follows the rules of DELETE /api/v2/teams/{team_id}/permissions.

Requires manage on the team: being one of its admins, or an organization admin.

Request

Path Params

Header Params

Body Params

application/json

Required

Examples

Responses

🟢200

application/json

Every item was tried. This status is sent even when every item failed: data.revoked lists the items applied and data.failed the rest.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE 'https:///api/v2/teams//permissions/batch' \
--header 'X-Authorization-Consistency-Token;' \
--header 'Organization-Id;' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "revokes": [
        {
            "subject_type": "user",
            "subject_id": "456",
            "relation": "all"
        },
        {
            "subject_type": "user",
            "subject_id": "789",
            "relation": "member"
        },
        {
            "subject_type": "user",
            "subject_id": "321",
            "relation": "admin"
        }
    ]
}'

Response Example

200 - Some items failed

{
    "success": true,
    "message": "Batch revoke completed: 1 revoked, 2 failed",
    "data": {
        "team_id": 9,
        "revoked": [
            {
                "subject_type": "user",
                "subject_id": "21",
                "subject_name": "Sam Ortiz",
                "revoked_relations": [
                    "member"
                ]
            }
        ],
        "failed": [
            {
                "subject_type": "user",
                "subject_id": "15",
                "subject_name": "Dana Lee",
                "error": "User does not have member permission"
            },
            {
                "subject_type": "user",
                "subject_id": "48",
                "subject_name": null,
                "error": "User not found in organization"
            }
        ],
        "revoked_at": "2026-10-28T14:14:09.873001+00:00"
    }
}

Grant Multiple Permissions on a Team

Get User Permissions on a Specific Team