# Create an organization role

**POST /api/organization-roles**

Create a new organization role with the given data.


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


## Authentication methods
- O auth2


## Parameters



### Body: application/json (object)

- **tenantId** (string)

- **name** (string)
  The name of the organization role. It must be unique within the organization template.
- **description** (string | null)
  The description of the organization role.
- **type** (string)

- **organizationScopeIds** (array[string])
  An array of organization scope IDs to be assigned to the organization role.
- **resourceScopeIds** (array[string])
  An array of resource scope IDs to be assigned to the organization role.


## Responses
### 201
The organization role was created successfully.

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

- **id** (string)

- **name** (string)

- **description** (string | null)

- **type** (string)


### 400
Bad Request

### 401
Unauthorized

### 403
Forbidden

### 422
The organization role name is already in use.


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