---
title: "GET /roles/{id}/"
method: GET
path: "/roles/{id}/"
tags: ["roles"]
---

# GET /roles/{id}/

`GET /roles/{id}/`

Retrieve a role by id

## Path parameters

- `id` string, uuid, required

## Response `200`

Return a role.

- RoleDetail
  - `id` string, uuid, required — Unique UUID of the role
  - `name` string, required — Name of the rulebook
  - `description` string, nullable — Description of the rulebook
  - `permissions` PermissionRef[], required
    - `resource_type` 'activation' | 'activation_instance' | 'audit_rule' | 'audit_event' | 'task' | 'user' | 'project' | 'inventory' | 'extra_var' | 'playbook' | 'rulebook' | 'role' | 'decision_environment' | 'credential', required — * `activation` - activation * `activation_instance` - activation_instance * `audit_rule` - audit_rule * `audit_event` - audit_event * `task` - task * `user` - user * `project` - project * `inventory` - inventory * `extra_var` - extra_var * `playbook` - playbook * `rulebook` - rulebook * `role` - role * `decision_environment` - decision_environment * `credential` - credential
    - `action` 'create' | 'read' | 'update' | 'delete' | 'enable' | 'disable' | 'restart', required — * `create` - create * `read` - read * `update` - update * `delete` - delete * `enable` - enable * `disable` - disable * `restart` - restart
  - `created_at` string, date-time, required — The created_at timestamp of the ruleset
  - `modified_at` string, date-time, required — The modified_at timestamp of the ruleset

## Changes

- **2023-05-19** `f84d9240fdf2` — 1 info
  - the endpoint scheme security `cookieAuth` was removed from the API
- **2023-04-25** `62d33b790834` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ansible/apis/event-driven-ansible-api/changes/roles/:id/get.md)

---

[API](https://skmtc.dev/ansible/apis/event-driven-ansible-api.md) · [All operations](https://skmtc.dev/ansible/apis/event-driven-ansible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ansible/event-driven-ansible-api/revisions/f84d9240fdf2/schema)