> ## Documentation Index
> Fetch the complete documentation index at: https://api.buildingswell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Role

> Permission roles.

Permission roles. Standard CRUD applies. See [standard endpoints](/guides/standard-endpoints).

**Search columns:** `name`, `description`

<Info>
  Requires admin access or the `Role.Read` / `Role.Update` permission.
</Info>

## Fields

| Field            | Type           | Notes                              |
| ---------------- | -------------- | ---------------------------------- |
| `id`             | UUID           | Auto-generated                     |
| `organizationId` | UUID           | From API key                       |
| `name`           | string         | Required                           |
| `description`    | string \| null |                                    |
| `permissions`    | string\[]      | Legacy permission strings          |
| `permissionsV2`  | object\[]      | Fine-grained permission statements |
| `createdAt`      | date           | Auto-generated                     |
| `updatedAt`      | date           | Auto-generated                     |

## Duplicate a role

```http theme={null}
POST /role/:id/duplicate
```

Response: `{ "value": { ... } }` — a new role with a unique name and the same permissions.