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

# Create a role

`POST /app/v1/roles`

## Request body

- CreateRoleInput
  - `name` string
  - `description` string
  - `status` 'active' | 'disabled'

## Response `200`

A successful operation

- Role
  - `name` string
  - `description` string
  - `status` 'active' | 'disabled'
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string, uuid
  - `updated_by` string, uuid
  - `id` string, uuid
  - `company_id` string, uuid

---

[API](https://skmtc.net/validere/apis/carbonhub-api.md) · [All operations](https://skmtc.net/validere/apis/carbonhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/validere/carbonhub-api/revisions/053edab62415/schema)