---
title: "Create a new role"
method: POST
path: "/Roles"
tags: ["Roles"]
---

# Create a new role

`POST /Roles`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/Roles`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/Roles/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- CreateRoleRequest
  - `name` string
  - `description` string, nullable
  - `permissions` string[]
  - `minStaff` union
    - integer
    - string, int32
  - `maxStaff` union
    - integer
    - string, int32
  - `isPrimaryProvider` boolean
  - `canPrescribe` boolean
  - `requiresTimeTracking` boolean

## Response `200`

OK

- RoleResponseDto
  - `id` string
  - `name` string
  - `description` string, nullable
  - `isSystemRole` boolean
  - `permissions` string[]
  - `minStaff` union
    - integer
    - string, int32
  - `maxStaff` union
    - integer
    - string, int32
  - `isPrimaryProvider` boolean
  - `canPrescribe` boolean
  - `requiresTimeTracking` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time, nullable

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)