Skip to main content
POST
/
permissions
curl -X POST 'https://api.example.com/permissions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "delete:documents",
    "description": "Can delete documents",
    "scopeId": "scope_123"
  }'

{
  "id": "perm_456",
  "name": "delete:documents",
  "description": "Can delete documents",
  "scopeId": "scope_123"
}

​
Request Body

​
name
string
required
Display name for the permission (e.g., read:documents)
​
description
string
Description of what this permission allows
​
scopeId
string
required
The scope ID where this permission will be defined

​
Response

Returns the created permission object. 
curl -X POST 'https://api.example.com/permissions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "delete:documents",
    "description": "Can delete documents",
    "scopeId": "scope_123"
  }'

{
  "id": "perm_456",
  "name": "delete:documents",
  "description": "Can delete documents",
  "scopeId": "scope_123"
}