---
title: "Get allowed actions for a role"
method: GET
path: "/management/v1/role/{role_id}/actions"
tags: ["role"]
---

# Get allowed actions for a role

`GET /management/v1/role/{role_id}/actions`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/management/v1/role/{role_id}/actions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/docs/management/v1/role/:role_id/actions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `role_id` string, uuid, required

## Query parameters

- `principalUser` string
- `principalRole` string, uuid

## Headers

- `x-project-id` string, nullable

## Response `200`

- GetLakekeeperRoleActionsResponse
  - `allowed-actions` LakekeeperRoleActionKind[], required
    - union
      - object
        - `action` 'read', required
      - object
        - `action` 'read_metadata', required
      - object
        - `action` 'delete', required
      - object
        - `action` 'update', required
      - object
        - `action` 'manage_role_assignments', required
      - object
        - `action` 'read_role_assignments', required
      - object
        - `action` 'update_source_system', required

## Other responses

- `4XX`

---

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