---
title: "User groups permissions for a given meta site"
method: GET
path: "/api/access-control/v2/meta-site/{meta_site_id}/permission/user-group"
tags: ["Access Control"]
---

# User groups permissions for a given meta site

`GET /api/access-control/v2/meta-site/{meta_site_id}/permission/user-group`

## Request

- Base URL: `https://example.piwik.pro`
- URL: `https://example.piwik.pro/api/access-control/v2/meta-site/{meta_site_id}/permission/user-group`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/auth/token`
- TypeScript: <https://skmtc.dev/piwik/apis/web-api/docs/api/access-control/v2/meta-site/:meta_site_id/permission/user-group/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all user groups and their permission for a given meta site.

## Path parameters

- `meta_site_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `sort` 'name' | '-name'

## Response `200`

OK

- object
  - `meta` object, required: Metadata of a listing
    - `total` integer, required: Total number of items
  - `data` object[], required
    - `id` string, uuid, required: Resource ID
    - `type` 'meta-site/permission/user-group', required
    - `attributes` object, required
      - `name` string, required: Name of user group
      - `permission` 'no-access' | 'view' | 'edit' | 'manage', required: Permission for `ppms/meta-site` (for example `manage` contains actions `view` nad `edit`)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

---

[API](https://skmtc.dev/piwik/apis/web-api.md) - [All operations](https://skmtc.dev/piwik/apis/web-api/llms.txt) - [OpenAPI document](https://skmtc.dev/piwik/apis/web-api/revisions/8b8abe1ab4f1?raw)