Revoke Permission on a Project

DELETE

/api/v2/projects/{project_id}/permissions

Removes a user's or team's role on a project. They keep any access that comes from elsewhere,
such as a team they belong to or being an organization admin.

Removing a user's last role also stops the project's notifications for them. Removing a role
from a team succeeds even when the team didn't hold it.

Requires manage on the project, which project admins (directly or through a team) and
organization admins have.

Request

Path Params

Header Params

Body Params

application/json

Required

Examples

Responses

🟢200

application/json

The roles were removed.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

cURL

Revoke all permissions from userRevoke specific permission from teamRevoke admin permission only

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

Response Example

200 - All roles removed from a user

{
    "success": true,
    "message": "Permission revoked successfully",
    "data": {
        "project_id": 7,
        "subject_type": "user",
        "subject_id": "21",
        "subject_name": "Sam Ortiz",
        "revoked_relations": [
            "member"
        ],
        "revoked_roles": [
            "member"
        ],
        "revoked_at": "2026-10-28T14:10:31.704422+00:00"
    }
}

Update a Permission on a Project

Grant Multiple Permissions on a Project