---
title: "Get Role Metadata"
method: GET
path: "/management/v1/role/{role_id}/metadata"
tags: ["role"]
---

# Get Role Metadata

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

## Request

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

Retrieves high-level metadata about a specific role.
Depending on the authorizer, this method is typically allowed also for roles in
other projects.

## Path parameters

- `role_id` string, uuid, required

## Response `200`

High level Role Metadata

- RoleMetadata: Metadata of a role with reduced information. Returned for cross-project role references.
  - `id` string, uuid, required: Globally unique UUID identifier
  - `ident` string, required: Composite project-scoped identifier (`provider~source_id`).
  - `name` string, required: Name of the role
  - `project-id` string, required: Project ID in which the role is created.
  - `provider-id` string, required: Provider that owns this role (e.g. `"lakekeeper"`, `"oidc"`).
  - `source-id` string, required: Identifier of the role in the provider.

## 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)