---
title: "Get permissions for the workspace"
method: GET
path: "/api/v1/layout/workspaces/{workspaceId}/permissions"
tags: ["Permissions"]
---

# Get permissions for the workspace

`GET /api/v1/layout/workspaces/{workspaceId}/permissions`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/layout/workspaces/{workspaceId}/permissions`
- Auth: none declared

Retrieve current set of permissions of the workspace in a declarative form.

## Path parameters

- `workspaceId` string, required

## Response `200`

Retrieved current set of permissions.

- DeclarativeWorkspacePermissions: Definition of permissions associated with a workspace.
  - `hierarchyPermissions` DeclarativeWorkspaceHierarchyPermission[]
    - `assignee` AssigneeIdentifier, required: Identifier of a user or user-group.
      - `id` string, required: Identifier of the assignee.
      - `type` 'user' | 'userGroup', required
    - `name` 'MANAGE' | 'ANALYZE' | 'EXPORT' | 'EXPORT_TABULAR' | 'EXPORT_PDF' | 'CREATE_AUTOMATION' | 'USE_AI_ASSISTANT' | 'WRITE_KNOWLEDGE_DOCUMENTS' | 'READ_KNOWLEDGE_DOCUMENTS' | 'CREATE_FILTER_VIEW' | 'CREATE_METRIC' | 'MANAGE_VISUALIZATIONS' | 'CREATE_VISUALIZATION' | 'CREATE_COMPUTED_ATTRIBUTE' | 'CREATE_DOCUMENT' | 'VIEW', required: Permission name.
  - `permissions` DeclarativeSingleWorkspacePermission[]
    - `assignee` AssigneeIdentifier, required: Identifier of a user or user-group.
      - `id` string, required: Identifier of the assignee.
      - `type` 'user' | 'userGroup', required
    - `name` 'MANAGE' | 'ANALYZE' | 'EXPORT' | 'EXPORT_TABULAR' | 'EXPORT_PDF' | 'CREATE_AUTOMATION' | 'USE_AI_ASSISTANT' | 'WRITE_KNOWLEDGE_DOCUMENTS' | 'READ_KNOWLEDGE_DOCUMENTS' | 'CREATE_FILTER_VIEW' | 'CREATE_METRIC' | 'MANAGE_VISUALIZATIONS' | 'CREATE_VISUALIZATION' | 'CREATE_COMPUTED_ATTRIBUTE' | 'CREATE_DOCUMENT' | 'VIEW', required: Permission name.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)