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

# Set permissions for the workspace

`PUT /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

Set effective permissions for the workspace

## Path parameters

- `workspaceId` string, required

## Request body

- 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.

## Response `204`

Workspace permissions successfully set.

---

[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)