---
title: "POST /v1/account/role"
method: POST
path: "/v1/account/role"
tags: ["account"]
---

# POST /v1/account/role

`POST /v1/account/role`

## Request

- Base URL: `https://api.thebridge.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebridge.dev/v1/account/role`
- Auth: none declared

## Request body

- CreateRoleRequestDto
  - `name` string, required
  - `key` string, required
  - `description` string
  - `privileges` string[], required
  - `isDefault` boolean, required

## Response `201`

- RoleResponseDto
  - `id` string, required: Logical id reference to this instance
  - `name` string, required: Name of the role
  - `key` string, required: The key of the role, used for reference
  - `description` string: An optional description of the role
  - `privileges` PrivilegeResponseDto[], required: The collection of Privileges
    - `id` string, required: Logical id reference to this instance
    - `key` string, required: The key of the privilege, used for reference
    - `description` string: An optional description of the privilege
  - `isDefault` boolean, required: Is this the default role

---

[API](https://skmtc.dev/thebridge/apis/bridge-api.md) · [All operations](https://skmtc.dev/thebridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebridge/apis/bridge-api/revisions/290fffcb3d80?raw)