---
title: "Create time tracking role"
method: POST
path: "/tt_role"
tags: ["[v1] Roles & Permissions"]
---

# Create time tracking role

`POST /tt_role`

Create time tracking role.

## Request body

- object
  - `tt_role_name` string — name of the role
  - `tt_role_sort` integer — role priority (lower number means higher priority)
  - `perms` object — array of permissions to add to role
    - `[perm_id]` integer — [perm-id] as key and `1` as value to add given [perm-id] to role

## Response `201`

Created

- object
  - `tt_role_id` union
    - string
    - integer
  - `tt_role_name` string
  - `root_group_id` union
    - string
    - integer
  - `overridden_role_id` union
    - string
    - integer
  - `tt_role_sort` integer

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

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