List ZITADEL Permissions
POST/users/:userId/memberships/_search
Show all the permissions the user has in ZITADEL (ZITADEL Manager).
Request​
Path Parameters
list limitations and ordering
Header Parameters
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
Body
required
Array [
]
query
object
Object unspecific list filters like offset, limit and asc/desc.
Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
default is descending
queries
object[]
orgQuery
object
projectQuery
object
projectGrantQuery
object
iamQuery
object
Body
required
Array [
]
query
object
Object unspecific list filters like offset, limit and asc/desc.
Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
default is descending
queries
object[]
orgQuery
object
projectQuery
object
projectGrantQuery
object
iamQuery
object
Body
required
Array [
]
query
object
Object unspecific list filters like offset, limit and asc/desc.
Maximum amount of events returned. The default is set to 1000 in https://github.com/zitadel/zitadel/blob/new-eventstore/cmd/zitadel/startup.yaml. If the limit exceeds the maximum configured ZITADEL will throw an error. If no limit is present the default is taken.
default is descending
queries
object[]
orgQuery
object
projectQuery
object
projectGrantQuery
object
iamQuery
object
Responses​
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the view got updated
result
object[]
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
display name of the user
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-11-21T14:48:17.193Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-11-21T14:48:17.193Z",
"changeDate": "2024-11-21T14:48:17.193Z",
"resourceOwner": "69629023906488334"
},
"roles": [
"IAM_OWNER"
],
"displayName": "Gigi Giraffe",
"iam": true,
"orgId": "string",
"projectId": "string",
"projectGrantId": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the view got updated
result
object[]
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
display name of the user
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-11-21T14:48:17.194Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-11-21T14:48:17.194Z",
"changeDate": "2024-11-21T14:48:17.194Z",
"resourceOwner": "69629023906488334"
},
"roles": [
"IAM_OWNER"
],
"displayName": "Gigi Giraffe",
"iam": true,
"orgId": "string",
"projectId": "string",
"projectGrantId": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object
the last time the view got updated
result
object[]
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
display name of the user
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
one of type use iam, org id, project id or project grant id
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2024-11-21T14:48:17.195Z"
},
"result": [
{
"userId": "69629023906488334",
"details": {
"sequence": "2",
"creationDate": "2024-11-21T14:48:17.195Z",
"changeDate": "2024-11-21T14:48:17.195Z",
"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
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}