---
title: "Create a new role"
method: POST
path: "/v2/organisations/{organisation_id}/roles"
tags: ["Gateway GRPC"]
---

# Create a new role

`POST /v2/organisations/{organisation_id}/roles`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/roles`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Request body

- CreateRoleDto
  - `name` string, required: Name of the role
  - `description` string, required: Description of the role
  - `permission_ids` string[], required: List of permission ids
  - `level` 0 | 1: Visibility level of the role

## Response `200`

- CreateRoleResponseDto
  - `success` boolean, required: Success status
  - `message` string, required: Response Message
  - `role_id` string: Newly created Role ID

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)