Bulk Remove User Grants​
Remove a list of user grants. The users will not be able to use the granted project anymore. Also, the roles will not be included in the tokens when requested.
Header Parameters
x-zitadel-orgid string
The default is always the organization of the requesting user. If you like to get/set a result of another organization include the header. Make sure the user has permission to access the requested data.
application/json
application/grpc
application/grpc-web+proto
Request Body required
grantId string[]
Request Body required
grantId string[]
Request Body required
grantId string[]
Responses
- 200
- default
A successful response.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
object
{}
Schema
Example (from schema)
Schema
object
{}
Schema
Example (from schema)
Schema
object
{}
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"
}
]
}
DELETE /user_grants/_bulk
Authorization
name: OAuth2type: oauth2scopes:openid,urn:zitadel:iam:org:project:id:zitadel:aud
flows: { "authorizationCode": { "authorizationUrl": "$CUSTOM-DOMAIN/oauth/v2/authorize", "tokenUrl": "$CUSTOM-DOMAIN/oauth/v2/token", "scopes": { "openid": "openid", "urn:zitadel:iam:org:project:id:zitadel:aud": "urn:zitadel:iam:org:project:id:zitadel:aud" } } }
Request
Request
curl / cURL
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
python / requests
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
go / native
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
nodejs / axios
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
ruby / Net::HTTP
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
csharp / RestSharp
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
php / cURL
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
java / OkHttp
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'
powershell / RestMethod
curl -L -X DELETE 'https://$CUSTOM-DOMAIN/management/v1/user_grants/_bulk' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"grantId": [
"9384786806489455",
"2984754806489455"
]
}'