---
title: "Get available permissions"
method: GET
path: "/v1/permissions"
tags: ["Permission"]
---

# Get available permissions

`GET /v1/permissions`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/permissions`
- Auth: none declared

Returns all permissions available for assignment to organization wide roles.

## Response `200`

Permissions retrieved successfully

- AvailablePermission[]
  - `action` string, required: Action being permitted (e.g., view, edit)
  - `category` string, required: The category that the permission belongs to
  - `description` string, required: Human-readable description of what this permission allows
  - `id` string, required: Unique identifier for this permission
  - `resource` string, required: Resource type (e.g., jobs, users, integrations)

## Other responses

- `403`: Insufficient permissions

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)