ATatlassian
Content Permissions

Get folder permissions

Changed on

Returns the direct content permissions on a folder with optional filtering. Results are cursor-paginated (max 250 per page).

Permissions required: Permission to view the folder.

get/folders/{id}/permissions

Request

  • Base URL
    https://no-default/wiki/api/v2
  • URL
    https://no-default/wiki/api/v2/folders/{id}/permissions
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: read:folder:confluence

Path parameters

idinteger required

The ID of the folder.

Query parameters

operation'read' | 'update'

Filter by operation (read or update).

principal-type'user' | 'group'

Filter by principal type (user or group). May be used without principal-id to return all permissions for that type.

principal-idstring

Filter by principal ID. Must be provided together with principal-type.

cursorstring

Opaque cursor for pagination. Use the value from the previous response's _links.next.

limitinteger

Maximum number of permission entries to return. Must be between 1 and 250.

Response

Returned if the permissions are successfully retrieved.

Changes