Update workbook access bindings
Updates access bindings for the specified workbook.
Request
POST
https://api.datalens.tech/rpc/updateWorkbookAccessBindings
Headers
|
Name |
Description |
|
x-dl-api-version |
Type: string API version header. Const: Example: |
Body
application/json
{
"workbookId": "example",
"deltas": [
{
"action": "ADD",
"accessBinding": {
"roleId": "example",
"subject": {
"id": "example",
"type": "system"
}
}
}
]
}
|
Name |
Description |
|
deltas |
Type: USAccessBindingDelta[] Access binding changes to apply. Example |
|
workbookId |
Type: string ID of the workbook whose access bindings to update. Example: |
USAccessBindingDelta
|
Name |
Description |
||||||||
|
accessBinding |
Type: object
Access binding to add or remove. Example |
||||||||
|
action |
Type: string Action to perform on the access binding. Enum: |
Example
{
"action": "ADD",
"accessBinding": {
"roleId": "example",
"subject": {
"id": "example",
"type": "system"
}
}
}
Responses
200 OK
Response
Body
application/json
{
"id": "example",
"description": "example",
"createdBy": "example",
"createdAt": {
"seconds": "example",
"nanos": 0.5
},
"modifiedAt": {
"seconds": "example",
"nanos": 0.5
},
"metadata": {},
"done": true
}
|
Name |
Description |
||||
|
createdAt |
Type: object
Operation creation timestamp. Example |
||||
|
createdBy |
Type: string ID of the user who created the operation. Example: |
||||
|
description |
Type: string Description of the operation. Example: |
||||
|
done |
Type: boolean Indicates if the operation has completed. |
||||
|
id |
Type: string Unique identifier of the operation. Example: |
||||
|
metadata |
Type: objectMetadata associated with the operation. Example |
||||
|
modifiedAt |
Type: object
Operation last modification timestamp. Example |