Revoke permission on a project

DELETE

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

Revokes (removes) access to a project for a user or team.
This removes the direct permission relationship, preventing the specified user or team from accessing the project unless they have access through other means (like organization admin).

Path Parameters:

project_id (int): The ID of the project

Request Body:

subject_type (str, required): Type of subject ("user" or "team")

subject_id (str, required): Unique identifier of the user or team

relation (str, optional): Specific role to revoke ("admin", "member", or "all"). Defaults to "all"

Revoke Options:

relation: "all" (default): Removes all roles

relation: "admin": Removes only the admin role

relation: "member": Removes only the member role

Authorization:

Requires manage permission on the project

Note:

Organization administrators will retain access even if revoked here, as their access is inherited from the organization level

Returns:

A response containing the revoked permission details

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200

application/json

Successfully revoked permission

Body

🟠400

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request DELETE 'https:///api/v2/projects//permissions' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "project_id": 0,
        "subject_type": "string",
        "subject_id": "string",
        "subject_name": "string",
        "revoked_relations": [
            "string"
        ],
        "revoked_at": "2019-08-24T14:15:22.123Z"
    }
}

Update a permission on a project

Grant multiple permissions on a project