---
title: "Create Organization Role"
method: POST
path: "/auth/organization/create-role"
tags: ["Organization Management"]
---

# Create Organization Role

`POST /auth/organization/create-role`

Create Organization Role

## Request body

- object
  - `organizationId` string
  - `role` string, required — The name of the role to create
  - `permission` object, required — The permission to assign to the role
  - `additionalFields` object

## Response `200`

Success

## Other responses

- `401` — Missing or invalid credentials

## Changes

- **2026-08-24** `9d1da42c10ce` — 1 breaking
  - the `permission/additionalProperties/` request property type/format changed from ``/`` to `array`/``
- **2026-08-24** `200744ae0bef` — 3 breaking
  - the request property `additionalFields` became not nullable
  - the request property `organizationId` became not nullable
  - the `permission` request property type/format changed from `string`/`` to `object`/``
- **2026-08-24** `08bbb5bedb5d` — 3 breaking, 7 info
  - the request property `additionalFields` became not nullable
  - the request property `organizationId` became not nullable
  - removed the media type `application/json` for the response with the status `401`
  - the endpoint scheme security `bearerAuth` was removed from the API
  - …6 more
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/auth/organization/create-role/post.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)