List My Authorizations/Grants
Returns a list of the authorizations/user grants the authenticated user has. User grants consist of an organization, a project and 1-n roles.
- application/json
- application/grpc
- application/grpc-web+proto
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum 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.
asc booleandefault is descending
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum 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.
asc booleandefault is descending
Request Body required
query object
Object unspecific list filters like offset, limit and asc/desc.
offset uint64limit int64Maximum 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.
asc booleandefault is descending
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
result object[]
Array [orgId stringprojectId stringuserId stringroles string[]orgName stringgrantId stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toorgDomain stringprojectName stringprojectGrantId stringroleKeys string[]userType stringPossible values: [
TYPE_UNSPECIFIED
,TYPE_HUMAN
,TYPE_MACHINE
]Default value:
TYPE_UNSPECIFIED
type of the user (human / machine)
]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-02"
},
"result": [
{
"orgId": "69629026806489455",
"projectId": "98729028932384528",
"userId": "28746028909593987",
"roles": [
"RoleKey1",
"RoleKey2"
],
"orgName": "ZITADEL",
"grantId": "",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"orgDomain": "zitadel.cloud",
"projectName": "ZITADEL",
"projectGrantId": "28746028909586246",
"roleKeys": [
"RoleKey1",
"RoleKey2"
],
"userType": "TYPE_UNSPECIFIED"
}
]
}
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
result object[]
Array [orgId stringprojectId stringuserId stringroles string[]orgName stringgrantId stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toorgDomain stringprojectName stringprojectGrantId stringroleKeys string[]userType stringPossible values: [
TYPE_UNSPECIFIED
,TYPE_HUMAN
,TYPE_MACHINE
]Default value:
TYPE_UNSPECIFIED
type of the user (human / machine)
]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-02"
},
"result": [
{
"orgId": "69629026806489455",
"projectId": "98729028932384528",
"userId": "28746028909593987",
"roles": [
"RoleKey1",
"RoleKey2"
],
"orgName": "ZITADEL",
"grantId": "",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"orgDomain": "zitadel.cloud",
"projectName": "ZITADEL",
"projectGrantId": "28746028909586246",
"roleKeys": [
"RoleKey1",
"RoleKey2"
],
"userType": "TYPE_UNSPECIFIED"
}
]
}
- Schema
- Example (from schema)
Schema
details object
totalResult uint64processedSequence uint64viewTimestamp date-timethe last time the view got updated
result object[]
Array [orgId stringprojectId stringuserId stringroles string[]orgName stringgrantId stringdetails object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
creationDate date-timeon read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the
resourceOwner resource_owner is the organization an object belongs toorgDomain stringprojectName stringprojectGrantId stringroleKeys string[]userType stringPossible values: [
TYPE_UNSPECIFIED
,TYPE_HUMAN
,TYPE_MACHINE
]Default value:
TYPE_UNSPECIFIED
type of the user (human / machine)
]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2023-05-02"
},
"result": [
{
"orgId": "69629026806489455",
"projectId": "98729028932384528",
"userId": "28746028909593987",
"roles": [
"RoleKey1",
"RoleKey2"
],
"orgName": "ZITADEL",
"grantId": "",
"details": {
"sequence": "2",
"creationDate": "2023-05-02",
"changeDate": "2023-05-02",
"resourceOwner": "69629023906488334"
},
"orgDomain": "zitadel.cloud",
"projectName": "ZITADEL",
"projectGrantId": "28746028909586246",
"roleKeys": [
"RoleKey1",
"RoleKey2"
],
"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[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}