List ZITADEL Permissions​
Show all the permissions the user has in ZITADEL (ZITADEL Manager).
Path Parameters
userId string required
list limitations and ordering
Header Parameters
x-zitadel-orgid string
The default is always the organization of the requesting user. If you like to get the 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
query object
queries object[]
Request Body required
query object
queries object[]
Request Body required
query object
queries object[]
Responses
- 200
- default
A successful response.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
details object
result object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-05-24T10:54:21.901Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-05-24T10:54:21.901Z",
"changeDate": "2024-05-24T10:54:21.901Z",
"resourceOwner": "69629023906488334"
},
"roles": [
"IAM_OWNER"
],
"displayName": "Gigi Giraffe",
"iam": true,
"orgId": "string",
"projectId": "string",
"projectGrantId": "string"
}
]
}
Schema
Example (from schema)
Schema
details object
result object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-05-24T10:54:21.901Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-05-24T10:54:21.901Z",
"changeDate": "2024-05-24T10:54:21.901Z",
"resourceOwner": "69629023906488334"
},
"roles": [
"IAM_OWNER"
],
"displayName": "Gigi Giraffe",
"iam": true,
"orgId": "string",
"projectId": "string",
"projectGrantId": "string"
}
]
}
Schema
Example (from schema)
Schema
details object
result object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-05-24T10:54:21.901Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-05-24T10:54:21.901Z",
"changeDate": "2024-05-24T10:54:21.901Z",
"resourceOwner": "69629023906488334"
},
"roles": [
"IAM_OWNER"
],
"displayName": "Gigi Giraffe",
"iam": true,
"orgId": "string",
"projectId": "string",
"projectGrantId": "string"
}
]
}
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"
}
]
}
POST /users/:userId/memberships/_search
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 POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
python / requests
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
go / native
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
nodejs / axios
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
ruby / Net::HTTP
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
csharp / RestSharp
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
php / cURL
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
java / OkHttp
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'
powershell / RestMethod
curl -L -X POST 'https://$CUSTOM-DOMAIN/management/v1/users/:userId/memberships/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
},
"queries": [
{
"orgQuery": {
"orgId": "69629023906488334"
},
"projectQuery": {
"projectId": "69629023906488334"
},
"projectGrantQuery": {
"projectGrantId": "69629023906488334"
},
"iamQuery": {
"iam": true
}
}
]
}'