Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.
Written by
View in Markdown

Modify permissions

Modifies permissions for the specified entry.

Request

POST

https://api.datalens.tech/rpc/modifyPermissions

Headers

Name

Description

x-dl-api-version

Type: string

API version header.

Const: 2

Example: 2

Body

application/json
{
  "entryId": "example",
  "body": {
    "diff": {
      "added": {
        "acl_adm": [
          {}
        ],
        "acl_edit": [
          {}
        ],
        "acl_view": [
          {}
        ],
        "acl_execute": [
          {}
        ]
      },
      "removed": {
        "acl_adm": [
          {}
        ],
        "acl_edit": [
          {}
        ],
        "acl_view": [
          {}
        ],
        "acl_execute": [
          {}
        ]
      },
      "modified": {
        "acl_adm": [
          {}
        ],
        "acl_edit": [
          {}
        ],
        "acl_view": [
          {}
        ],
        "acl_execute": [
          {}
        ]
      }
    }
  },
  "checkType": "straight",
  "nested": true,
  "page": 0.5,
  "pageSize": 0.5
}

Name

Description

body
Type: object

diff
Type: object

added
Type: object

acl_adm
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to grant admin access.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_edit
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to grant edit access.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_execute
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to grant execute access.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_view
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to grant view access.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

Permissions to add.

Example
{
  "acl_adm": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_edit": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_view": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_execute": [
    {
      "comment": "example",
      "subject": "example"
    }
  ]
}

modified
Type: object

acl_adm
Type: object[]

new
Type: object

grantType

Type: string

New ACL level to assign to the subject.

Enum: acl_view, acl_edit, acl_adm, acl_execute

subject

Type: string

New subject identifier after modification.

Example: example
Example
{
  "grantType": "acl_view",
  "subject": "example"
}

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Admin permission modifications.

Example
[
  {
    "comment": "example",
    "subject": "example",
    "new": {
      "grantType": "acl_view",
      "subject": "example"
    }
  }
]

acl_edit
Type: object[]

new
Type: object

grantType

Type: string

New ACL level to assign to the subject.

Enum: acl_view, acl_edit, acl_adm, acl_execute

subject

Type: string

New subject identifier after modification.

Example: example
Example
{
  "grantType": "acl_view",
  "subject": "example"
}

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Edit permission modifications.

Example
[
  {
    "comment": "example",
    "subject": "example",
    "new": {
      "grantType": "acl_view",
      "subject": "example"
    }
  }
]

acl_execute
Type: object[]

new
Type: object

grantType

Type: string

New ACL level to assign to the subject.

Enum: acl_view, acl_edit, acl_adm, acl_execute

subject

Type: string

New subject identifier after modification.

Example: example
Example
{
  "grantType": "acl_view",
  "subject": "example"
}

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Execute permission modifications.

Example
[
  {
    "comment": "example",
    "subject": "example",
    "new": {
      "grantType": "acl_view",
      "subject": "example"
    }
  }
]

acl_view
Type: object[]

new
Type: object

grantType

Type: string

New ACL level to assign to the subject.

Enum: acl_view, acl_edit, acl_adm, acl_execute

subject

Type: string

New subject identifier after modification.

Example: example
Example
{
  "grantType": "acl_view",
  "subject": "example"
}

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

View permission modifications.

Example
[
  {
    "comment": "example",
    "subject": "example",
    "new": {
      "grantType": "acl_view",
      "subject": "example"
    }
  }
]

Permissions to modify.

Example
{
  "acl_adm": [
    {
      "comment": "example",
      "subject": "example",
      "new": {
        "grantType": "acl_view",
        "subject": "example"
      }
    }
  ],
  "acl_edit": [
    {
      "comment": "example",
      "subject": "example",
      "new": {
        "grantType": "acl_view",
        "subject": "example"
      }
    }
  ],
  "acl_view": [
    {
      "comment": "example",
      "subject": "example",
      "new": {
        "grantType": "acl_view",
        "subject": "example"
      }
    }
  ],
  "acl_execute": [
    {
      "comment": "example",
      "subject": "example",
      "new": {
        "grantType": "acl_view",
        "subject": "example"
      }
    }
  ]
}

removed
Type: object

acl_adm
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to revoke admin access from.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_edit
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to revoke edit access from.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_execute
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to revoke execute access from.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

acl_view
Type: object[]

subject

Type: string

Subject identifier.

Example: example

comment

Type: string

Comment describing the reason for this permission change.

Example: example

Subjects to revoke view access from.

Example
[
  {
    "comment": "example",
    "subject": "example"
  }
]

Permissions to remove.

Example
{
  "acl_adm": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_edit": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_view": [
    {
      "comment": "example",
      "subject": "example"
    }
  ],
  "acl_execute": [
    {
      "comment": "example",
      "subject": "example"
    }
  ]
}

Set of permission changes to apply.

Example
{
  "added": {
    "acl_adm": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_edit": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_view": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_execute": [
      {
        "comment": "example",
        "subject": "example"
      }
    ]
  },
  "removed": {
    "acl_adm": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_edit": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_view": [
      {
        "comment": "example",
        "subject": "example"
      }
    ],
    "acl_execute": [
      {
        "comment": "example",
        "subject": "example"
      }
    ]
  },
  "modified": {
    "acl_adm": [
      {
        "comment": "example",
        "subject": "example",
        "new": {
          "grantType": "acl_view",
          "subject": "example"
        }
      }
    ],
    "acl_edit": [
      {
        "comment": "example",
        "subject": "example",
        "new": {
          "grantType": "acl_view",
          "subject": "example"
        }
      }
    ],
    "acl_view": [
      {
        "comment": "example",
        "subject": "example",
        "new": {
          "grantType": "acl_view",
          "subject": "example"
        }
      }
    ],
    "acl_execute": [
      {
        "comment": "example",
        "subject": "example",
        "new": {
          "grantType": "acl_view",
          "subject": "example"
        }
      }
    ]
  }
}

Permission changes to apply.

Example
{
  "diff": {
    "added": {
      "acl_adm": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_edit": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_view": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_execute": [
        {
          "comment": "example",
          "subject": "example"
        }
      ]
    },
    "removed": {
      "acl_adm": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_edit": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_view": [
        {
          "comment": "example",
          "subject": "example"
        }
      ],
      "acl_execute": [
        {
          "comment": "example",
          "subject": "example"
        }
      ]
    },
    "modified": {
      "acl_adm": [
        {
          "comment": "example",
          "subject": "example",
          "new": {}
        }
      ],
      "acl_edit": [
        {
          "comment": "example",
          "subject": "example",
          "new": {}
        }
      ],
      "acl_view": [
        {
          "comment": "example",
          "subject": "example",
          "new": {}
        }
      ],
      "acl_execute": [
        {
          "comment": "example",
          "subject": "example",
          "new": {}
        }
      ]
    }
  }
}

entryId

Type: string

ID of the entry to modify permissions for.

Example: example

checkType

Type: string

Scope of permission check: straight (direct), hierarchical, or root.

Enum: straight, hierarchical, root

nested

Type: boolean

Apply changes recursively to all nested entries.

page

Type: number

Page number for paginated results.

pageSize

Type: number

Number of results per page.

Responses

200 OK

Response

Body

application/json
{
  "result": "ok",
  "nextPageToken": "example"
}

Name

Description

result

Type: string

Const: ok

Example: example

nextPageToken

Type: string

Token for fetching the next page of results.

Example: example
Previous
Get permissions
Next
DLS suggest