---
title: "Retrieve a system-level Kargo Role virtual resource"
method: GET
path: "/v1beta1/system/roles/{role}"
tags: ["Rbac", "System-Level"]
---

# Retrieve a system-level Kargo Role virtual resource

`GET /v1beta1/system/roles/{role}`

Retrieve a system-level Kargo Role virtual resource by name.
Returns a Kargo Role virtual resource or its underlying
Kubernetes resources.

## Path parameters

- `role` string, required

## Response `200`

Role resource (k8s.io/api/rbac/v1.Role) or its underlying Kubernetes resources

- unknown

---

[API](https://skmtc.net/akuity/apis/kargo-api.md) · [All operations](https://skmtc.net/akuity/apis/kargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akuity/kargo-api/revisions/c53f80933e09/schema)