User Grant By ID
Returns a user grant per ID. A user grant is a role a user has for a specific project and organization.
Path Parameters
- userId string required
- grantId string required
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.
Responses
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
userGrant object
{
"userGrant": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"roleKeys": [
"role.super.man"
],
"state": "USER_GRANT_STATE_UNSPECIFIED",
"userId": "69629023906488334",
"userName": "gigi-giraffe",
"firstName": "Gigi",
"lastName": "Giraffe",
"email": "gigi@zitadel.com",
"displayName": "Gigi Giraffe",
"orgId": "69629023906488334",
"orgName": "ZITADEL",
"orgDomain": "zitadel.cloud",
"projectId": "69629023906488334",
"projectName": "ZITADEL",
"projectGrantId": "69629023906488334",
"avatarUrl": "{your-domain}/assets/v1/avatar-32432jkh4kj32",
"preferredLoginName": "gigi@zitadel.com",
"userType": "TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
userGrant object
{
"userGrant": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"roleKeys": [
"role.super.man"
],
"state": "USER_GRANT_STATE_UNSPECIFIED",
"userId": "69629023906488334",
"userName": "gigi-giraffe",
"firstName": "Gigi",
"lastName": "Giraffe",
"email": "gigi@zitadel.com",
"displayName": "Gigi Giraffe",
"orgId": "69629023906488334",
"orgName": "ZITADEL",
"orgDomain": "zitadel.cloud",
"projectId": "69629023906488334",
"projectName": "ZITADEL",
"projectGrantId": "69629023906488334",
"avatarUrl": "{your-domain}/assets/v1/avatar-32432jkh4kj32",
"preferredLoginName": "gigi@zitadel.com",
"userType": "TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
userGrant object
{
"userGrant": {
"id": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2023-05-12",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"roleKeys": [
"role.super.man"
],
"state": "USER_GRANT_STATE_UNSPECIFIED",
"userId": "69629023906488334",
"userName": "gigi-giraffe",
"firstName": "Gigi",
"lastName": "Giraffe",
"email": "gigi@zitadel.com",
"displayName": "Gigi Giraffe",
"orgId": "69629023906488334",
"orgName": "ZITADEL",
"orgDomain": "zitadel.cloud",
"projectId": "69629023906488334",
"projectName": "ZITADEL",
"projectGrantId": "69629023906488334",
"avatarUrl": "{your-domain}/assets/v1/avatar-32432jkh4kj32",
"preferredLoginName": "gigi@zitadel.com",
"userType": "TYPE_UNSPECIFIED"
}
}
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"
}
]
}
GET /users/:userId/grants/:grantId
Authorization
type: oauth2flow: authorizationCodescopes: openid,urn:zitadel:iam:org:project:id:zitadel:aud
Request
Request
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://$ZITADEL_DOMAIN/management/v1/users/:userId/grants/:grantId' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'