Identity & Access

Roles & Permissions

Manage roles and permissions for role-based access control (RBAC). Roles define what users can do; permissions are granular access rights.

Roles

Define role names and descriptions

Permissions

Assign permissions to roles

List & query

List roles and their permissions

List Roles

Query Parameters

Parameter	Type	Default	Description
`page`	`integer`	1	Page number
`limit`	`integer`	20	Items per page
`search`	`string`	—	Search by name

Request

HTTP

http

GET https://api.leadron.io/v1/roles
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
X-Tenant-Id: acme-corp

Response200OK

200 Response

json

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

{
  "success": true,
  "status": 200,
  "data": [
    {
      "id": "role_admin",
      "name": "Admin",
      "description": "Full access",
      "permissionCount": 50
    },
    {
      "id": "role_sales",
      "name": "Sales Rep",
      "description": "Sales access",
      "permissionCount": 20
    }
  ],
  "meta": {
    "timestamp": "2026-02-08T14:30:00.000Z",
    "version": "v1"
  }
}

Roles & Permissions

List Roles

Query Parameters

Create Role

Get Role

Update Role

Delete Role

Permissions