---
title: "Grant permission to role"
method: POST
path: "/workspaces/{workspacePublicId}/roles/{rolePublicId}/permissions/grant"
tags: ["Permissions"]
---

# Grant permission to role

`POST /workspaces/{workspacePublicId}/roles/{rolePublicId}/permissions/grant`

## Request

- Base URL: `https://kan.bn/api/v1`
- URL: `https://kan.bn/api/v1/workspaces/{workspacePublicId}/roles/{rolePublicId}/permissions/grant`
- Auth: HTTP bearer

Grant a specific permission to a role

## Path parameters

- `workspacePublicId` string, required
- `rolePublicId` string, required

## Request body

- object
  - `permission` 'workspace:view' | 'workspace:edit' | 'workspace:delete' | 'workspace:manage' | 'board:view' | 'board:create' | 'board:edit' | 'board:delete' | 'list:view' | 'list:create' | 'list:edit' | 'list:delete' | 'card:view' | 'card:create' | 'card:edit' | 'card:delete' | 'comment:view' | 'comment:create' | 'comment:edit' | 'comment:delete' | 'member:view' | 'member:invite' | 'member:edit' | 'member:remove', required

## Response `200`

Successful response

- object
  - `success` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

## Changes

- **2026-02-26** `29353a7e0062`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kan/apis/kan-api/changes/workspaces/:workspacePublicId/roles/:rolePublicId/permissions/grant/post.md)

---

[API](https://skmtc.dev/kan/apis/kan-api.md) - [All operations](https://skmtc.dev/kan/apis/kan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kan/apis/kan-api/revisions/1f881739cf03?raw)