Remove Project Role

Removes the role from the project and on every resource it has a dependency. This includes project grants and user grants (role assignments).

Required permission:

project.role.write

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

projectId*string

ProjectID is the unique identifier of the project.

roleKey*string

RoleKey is the key of the role to be removed. All dependencies of this role will be removed as well, including project grants and user grants (role assignments). If the role is not found, the request will return a successful response as the desired state is already achieved.

Response Body

`application/json`

curl -X POST "https://loading/zitadel.project.v2.ProjectService/RemoveProjectRole" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "projectId": "string",    "roleKey": "string"  }'

{
  "removalDate": "2023-01-15T01:30:15.01Z"
}

{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

Header Parameters

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`