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

# Get path permission details

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

## Request

- Base URL: `https://api.diversion.dev/v0`
- URL: `https://api.diversion.dev/v0/repos/{repo_id}/granular-permissions/{permission_id}`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.diversion.dev/oauth2/authorize`
    - Scopes: `coreapi/read`
  - OAuth 2
    - Implicit: `https://auth.diversion.dev/oauth2/authorize`
    - Scopes: `coreapi/write`
- TypeScript: <https://skmtc.dev/diversion/apis/diversion-core-api/docs/repos/:repo_id/granular-permissions/:permission_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get details of a specific path permission rule

## Response `200`

Path permission details returned

- GranularPermission
  - `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

- `404`: The specified resource was not found
- `default`: An error occurred

---

[API](https://skmtc.dev/diversion/apis/diversion-core-api.md) - [All operations](https://skmtc.dev/diversion/apis/diversion-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/diversion/apis/diversion-core-api/revisions/38a18aba804b?raw)