---
title: "Create a role"
method: POST
path: "/permissions/v1/roles"
tags: ["Roles"]
---

# Create a role

`POST /permissions/v1/roles`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/permissions/v1/roles`
- Auth: HTTP bearer

Creates a role with the given name, description and permissions, scoped to one or more structure types. Returns the created role.

## Request body

- S12StructuresRolesV1CreateRoleRequest
  - `structure_type_ids` string[], required: Required. List of structure type IDs to associate with the role. Limited to 100 per request.
  - `name` string, required: The role title
  - `description` string, required: The role description
  - `permissions` S12StructuresRolesV1PermissionType[]: The list of permissions enabled for this role.

## Response `200`

A successful response.

- S12StructuresRolesV1CreateRoleResponse
  - `role` S12StructuresRolesV1Role
    - `id` string: Unique identifier for the role
    - `name` string: The role title.
    - `description` string: The role description.
    - `permissions` S12StructuresRolesV1PermissionType[]: The list of permissions enabled for this role.
    - `structure_type_ids` string[]: List of structure type IDs associated with the role. Limited to 100.
    - `is_default` boolean: Whether this role is a default role. This field is output only and cannot be edited.
    - `user_count` integer: The number of users assigned to this role. This field is output only and cannot be edited.
    - `created_at` string, date-time: The date created timestamp of a role.
    - `modified_at` string, date-time: The date last modified timestamp of a role.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/permissions/v1/roles/post.md)

---

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