---
title: "Get Project Role"
method: GET
path: "/access/api/v1/projects/{projectKey}/roles/{role}"
tags: ["Roles"]
---

# Get Project Role

`GET /access/api/v1/projects/{projectKey}/roles/{role}`

Returns the requested project role.

**Security:** Requires Platform Admin or Project Admin privileges.

## Path parameters

- `projectKey` string, required
- `role` string, required

## Response `200`

Success

- ProjectRole
  - `name` string — Role name
  - `description` string — Role description
  - `type` 'PREDEFINED' | 'CUSTOM' | 'CUSTOM_GLOBAL' — Role type. `PREDEFINED` = built-in role, `CUSTOM` = project-scoped custom role, `CUSTOM_GLOBAL` = global custom role.
  - `environments` string[] — Environments for the role
  - `actions` string[] — Actions permitted by this role

## Other responses

- `401` — Bad Credentials - Invalid credentials
- `403` — Permission Denied - Insufficient permissions
- `404` — Not Found - Project or role not found

---

[API](https://skmtc.dev/jfrog/apis/jfrog-platform-projects-api.md) · [All operations](https://skmtc.dev/jfrog/apis/jfrog-platform-projects-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jfrog/jfrog-platform-projects-api/revisions/1c6bb09154a9/schema)