ZITADEL Docs
APIsCore ResourcesV2Project

UpdateProjectGrant

Update Project Grant

Change the roles of the project that is granted to another organization. The project grant will allow the granted organization to access the project and manage the authorizations for its users.

Required permission:

  • project.grant.write
POST
/zitadel.project.v2.ProjectService/UpdateProjectGrant

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

projectId*string

ProjectID is the unique identifier of the project.

grantedOrganizationId*string

GrantedOrganizationID is the unique identifier of the organization the project was granted to.

roleKeys?role_keys

RoleKeys is a list of roles to be granted to the organization for self management. The roles are identified by their keys. Any roles not included in this list will be removed from the project grant. If you want to add a role, make sure to include all other existing roles as well. If any previous role is removed, all user grants for this project grant with this role will be removed as well.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/zitadel.project.v2.ProjectService/UpdateProjectGrant" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "projectId": "string",    "grantedOrganizationId": "string"  }'
{
  "changeDate": "1s"
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?