---
title: "List Permissions"
method: GET
path: "/api/v2/permissions"
tags: ["Roles & Permissions"]
---

# List Permissions

`GET /api/v2/permissions`

Gets a list of valid permissions that can be assigned to users or API credentials.

HiddenLayer permissions follow a `resource:action` format, where:
- The resource name uses kebab-case (e.g., `model-version`)
- The action specifies what can be done with the resource (e.g., read, write)
- Resource and action are separated by a colon (:)

Hypothetical Example: `model-version:read` would grant permission to read model versions.

## Response `200`

A response containing a list of permissions

## Other responses

- `500` — An unexpected error occurred preventing the operation from being performed.

---

[API](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/revisions/193d6dfbca67/schema)