---
title: "Set permission group"
method: POST
path: "/api/user-groups/v1/{user_group_id}/permissions"
tags: ["User Groups"]
deprecated: true
---

# Set permission group

`POST /api/user-groups/v1/{user_group_id}/permissions`

> **Deprecated.**

Please use <a href="https://developers.piwik.pro/reference/set_app_permission_for_user_group_v2">Set user group permission for a given app</a> or <a href="https://developers.piwik.pro/reference/set_meta_site_permission_for_user_group_v2">Set user group permission for a given meta site</a> instead.<br><br> Sets permission group to entity for user group

## Path parameters

- `user_group_id` string, uuid, required

## Request body

- object
  - `data` object, required
    - `type` 'ppms/permissions/group', required — Resource type
    - `attributes` object, required
      - `entity_id` string, uuid, required — UUIDv4 identifier of an object
      - `group` 'no-access' | 'view' | 'edit' | 'edit-publish' | 'manage', required — Permission group (for example `edit-publish` contains permissions `view`, `edit` and `publish`)

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/piwik/apis/web-api.md) · [All operations](https://skmtc.net/piwik/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piwik/web-api/revisions/f63416a36168/schema)
