Get permissions
Returns permissions for the specified entry.
Request
POST
https://api.datalens.tech/rpc/getPermissions
Headers
|
Name |
Description |
|
x-dl-api-version |
Type: string API version header. Const: Example: |
Body
application/json
{
"entryId": "example"
}
|
Name |
Description |
|
entryId |
Type: string ID of the entry to get permissions for. Example: |
Responses
200 OK
Response
Body
application/json
{
"editable": true,
"pendingPermissions": {
"acl_adm": [
{
"approver": null,
"description": "example",
"extras": null,
"kind": "user",
"name": "example",
"requester": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {},
"__rlsid": "example",
"__source": "example"
},
"subject": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {},
"__rlsid": "example",
"__source": "example"
}
}
],
"acl_edit": [
null
],
"acl_view": [
null
],
"acl_execute": [
null
]
},
"permissions": {
"acl_adm": [
{
"approver": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {},
"__rlsid": "example",
"__source": "example"
},
"description": "example",
"extras": null,
"kind": "user",
"name": "example",
"requester": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {},
"__rlsid": "example",
"__source": "example"
},
"subject": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {},
"__rlsid": "example",
"__source": "example"
}
}
],
"acl_edit": [
null
],
"acl_view": [
null
],
"acl_execute": [
null
]
}
}
|
Name |
Description |
||||||||
|
editable |
Type: boolean Whether the current user can edit permissions for this entry. |
||||||||
|
pendingPermissions |
Type: object
Pending permission requests grouped by ACL level. Example |
||||||||
|
permissions |
Type: object
Granted permissions grouped by ACL level. Example |
DlsPermissionPendingParticipant
|
Name |
Description |
||||||||||||||||||||||||||
|
approver |
Type: null Always null for pending permissions. Example: |
||||||||||||||||||||||||||
|
description |
Type: string Human-readable description of the pending permission request. Example: |
||||||||||||||||||||||||||
|
extras |
Any of 3 types
Additional configuration for the permission request. Example: |
||||||||||||||||||||||||||
|
kind |
Type: string Participant kind. Enum: |
||||||||||||||||||||||||||
|
name |
Type: string Subject id. Example: |
||||||||||||||||||||||||||
|
requester |
Type: object | null User who submitted the permission request. Example |
||||||||||||||||||||||||||
|
subject |
Type: object
Subject details. Example |
Example
{
"approver": null,
"description": "example",
"extras": null,
"kind": "user",
"name": "example",
"requester": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {
"link": "example",
"title": "example"
},
"__rlsid": "example",
"__source": "example"
},
"subject": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {
"link": "example",
"title": "example"
},
"__rlsid": "example",
"__source": "example"
}
}
DlsPermissionParticipant
|
Name |
Description |
||||||||||||||||||||||||||
|
approver |
Type: object | null User who approved this permission. Example |
||||||||||||||||||||||||||
|
description |
Type: string Human-readable description of the permission. Example: |
||||||||||||||||||||||||||
|
extras |
Any of 3 types
Additional configuration for the permission. Example: |
||||||||||||||||||||||||||
|
kind |
Type: string Participant kind. Enum: |
||||||||||||||||||||||||||
|
name |
Type: string Subject id. Example: |
||||||||||||||||||||||||||
|
requester |
Type: object | null User who requested this permission. Example |
||||||||||||||||||||||||||
|
subject |
Type: object
Subject details. Example |
Example
{
"approver": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {
"link": "example",
"title": "example"
},
"__rlsid": "example",
"__source": "example"
},
"description": "example",
"extras": null,
"kind": "user",
"name": "example",
"requester": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {
"link": "example",
"title": "example"
},
"__rlsid": "example",
"__source": "example"
},
"subject": {
"cloud_icon": "example",
"cloud_icon_data": "example",
"cloud_user_id": "example",
"icon": "example",
"link": "example",
"name": "example",
"title": "example",
"type": "user",
"parent": {
"link": "example",
"title": "example"
},
"__rlsid": "example",
"__source": "example"
}
}