---
title: "Create Permission"
method: POST
path: "/permissions"
tags: ["Permission"]
---

# Create Permission

`POST /permissions`

Creates a new permission

## Headers

- `tenant-id` string

## Request body

- PermissionCreateRequest — Request body for creating a new permission
  - `resource` string — The resource name (e.g., 'user', 'roster')
  - `action` string — The action name (e.g., 'read', 'create')
  - `description` string — A brief description of the permission

## Response `201`

Permission created successfully

- PermissionResponseDto — Permission information response
  - `id` string — Permission ID
  - `resource` string — Resource name
  - `action` string — Action name
  - `description` string — Permission description
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

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