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

# Create permission

`POST /v1/permissions`

Create a new permission for a subject to the given target.

## Request body

- object
  - `kind` '*' | 'create' | 'write' | 'read' | 'delete', required — Kind of a permission.
  - `subject` object, required
    - `resourceType` 'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Todo' | 'User', required
    - `id` string, required
  - `target` object, required
    - `resourceType` 'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Todo' | 'User', required
    - `id` string, required

## Response `201`

Example response

- object
  - `id` string, required — ID of the newly created resource.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `500` — Internal Server Error

---

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