Get path permission details

Get details of a specific path permission rule

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

Get path permission details

cURL

curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/granular-permissions/{permission_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "repo_id": "<string>",
  "path_pattern": "<string>",
  "evaluation_order": 123,
  "created_unix": 123,
  "updated_unix": 123,
  "created_by": "<string>",
  "last_updated_by": "<string>",
  "user_id": "<string>",
  "group_id": "<string>"
}

Authorizations

OAuth2OAuth2

Authorization · string · header · required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

repo_id · string · required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128

Example:

"example_id"

permission_id · string · required

Permission identifier

Required string length: 3 - 128

Example:

"dv.perm.12a37e91-bfc4-4e03-a330-13b5b84ab7cb"

Response

200

application/json

Path permission details returned

id · string · required

Granular permission identifier

repo_id · string · required

Repository ID this permission belongs to

path_pattern · string · required

Path pattern for matching files

access_level · enum<string> · required

Access level for path permissions. Hierarchical: ADMIN > WRITE > READ > NO_ACCESS.

Available options: ADMIN, WRITE, READ, NO_ACCESS

permission_type · enum<string> · 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.

Available options: ALLOW_LT_EQ, ALLOW_EQ, DENY_ALL, DENY_EQ

evaluation_order · integer · required

Rule evaluation priority. Higher values are evaluated first (read-only).

created_unix · integer<int64> · required

Creation timestamp (Unix epoch)

updated_unix · integer<int64> · 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

user_id · string

User ID this permission is assigned to

group_id · string

Group ID this permission is assigned to