# Link scopes to role

**POST /api/roles/{id}/scopes**

Link a list of API resource scopes (permissions) to a role. The original linked scopes will be kept.


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters

### Path parameters
- **id** (string)
  The unique identifier of the role.


### Body: application/json (object)

- **scopeIds** (array[string])
  An array of API resource scope IDs to be linked.


## Responses
### 200
The role was linked to the scopes successfully.

### 201
Created

#### Body: application/json (array[object])
- **tenantId** (string)

- **id** (string)

- **resourceId** (string)

- **name** (string)

- **description** (string | null)

- **createdAt** (number)


### 400
Bad Request

### 401
Unauthorized

### 403
Forbidden

### 404
Not Found

### 422
Unprocessable Content


[Powered by Bump.sh](https://bump.sh)