---
title: "List granular permissions"
method: GET
path: "/repos/{repo_id}/granular-permissions"
tags: ["Repository Granular Permissions"]
---

# List granular permissions

`GET /repos/{repo_id}/granular-permissions`

List all granular permissions configured for this repository

## Query parameters

- `user_id` string
- `group_id` string

## Response `200`

A list of granular permission objects

- object
  - `items` GranularPermission[], required
    - `id` string, required — Granular permission identifier
    - `repo_id` string, required — Repository ID this permission belongs to
    - `user_id` string — User ID this permission is assigned to
    - `group_id` string — Group ID this permission is assigned to
    - `path_pattern` string, required — Path pattern for matching files
    - `access_level` 'ADMIN' | 'WRITE' | 'READ' | 'NO_ACCESS', required — Access level for path permissions. Hierarchical: ADMIN > WRITE > READ > NO_ACCESS.
    - `permission_type` 'ALLOW_LT_EQ' | 'ALLOW_EQ' | 'DENY_ALL' | 'DENY_EQ', required — Permission type controlling how access levels are granted or denied. ALLOW_LT_EQ grants specified level and all lower levels. ALLOW_EQ grants only the exact level. DENY_ALL denies all level granted above in the table. DENY_EQ denies only the exact level.
    - `evaluation_order` integer, required — Rule evaluation priority. Higher values are evaluated first (read-only).
    - `created_unix` integer, required — Creation timestamp (Unix epoch)
    - `updated_unix` integer, required — Last update timestamp (Unix epoch)
    - `created_by` string, required — User ID who created this permission
    - `last_updated_by` string, required — User ID who last updated this permission

## Other responses

- `400` — Invalid filter parameters
- `default` — An error occurred

---

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