Change Project Role
Change a project role. The key is not editable. If a key should change, remove the role and create a new one.
Path Parameters
- projectId string required
- roleKey string required
The key is the only relevant attribute for ZITADEL regarding the authorization checks.
Header Parameters
- x-zitadel-orgid string
The default is always the organization of the requesting user. If you like to change/get objects of another organization include the header. Make sure the requesting user has permission to access the requested data.
- application/json
- application/grpc
- application/grpc-web+proto
Request Body required
- displayName string required
Possible values:
non-empty
and<= 200 characters
- group string
Possible values:
<= 200 characters
The group is only used for display purposes. That you have better handling, like giving all the roles from a group to a user.
Request Body required
- displayName string required
Possible values:
non-empty
and<= 200 characters
- group string
Possible values:
<= 200 characters
The group is only used for display purposes. That you have better handling, like giving all the roles from a group to a user.
Request Body required
- displayName string required
Possible values:
non-empty
and<= 200 characters
- group string
Possible values:
<= 200 characters
The group is only used for display purposes. That you have better handling, like giving all the roles from a group to a user.
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
}
}
- Schema
- Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
}
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
PUT /projects/:projectId/roles/:roleKey
Authorization
type: oauth2flow: authorizationCodescopes: openid,urn:zitadel:iam:org:project:id:zitadel:aud
Request
Request
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'
curl -L -X PUT 'https://$ZITADEL_DOMAIN/management/v1/projects/:projectId/roles/:roleKey' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"displayName": "Administrator",
"group": "Admins"
}'