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"
}'
const axios = require('axios');
const { data } = await axios.post('https://api.example.com/permissions', {
name: 'delete:documents',
description: 'Can delete documents',
scopeId: 'scope_123',
}, {
headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
});
{
"id": "perm_456",
"name": "delete:documents",
"description": "Can delete documents",
"scopeId": "scope_123"
}
Permissions
Create Permission
Create a new permission within a scope
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"
}'
const axios = require('axios');
const { data } = await axios.post('https://api.example.com/permissions', {
name: 'delete:documents',
description: 'Can delete documents',
scopeId: 'scope_123',
}, {
headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
});
{
"id": "perm_456",
"name": "delete:documents",
"description": "Can delete documents",
"scopeId": "scope_123"
}
Request Body
string
required
Display name for the permission (e.g.,
read:documents)string
Description of what this permission allows
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"
}'
const axios = require('axios');
const { data } = await axios.post('https://api.example.com/permissions', {
name: 'delete:documents',
description: 'Can delete documents',
scopeId: 'scope_123',
}, {
headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
});
{
"id": "perm_456",
"name": "delete:documents",
"description": "Can delete documents",
"scopeId": "scope_123"
}
Was this page helpful?
⌘I