Karma Common API
​string​string​number · min: 1​number · min: 1 · max: 1000​string
​string · pattern: ​string · required​string | null​string | null​string
​number · required​string
Permission registry and management
List permissions
GET
https://common-api.karma.life
/api/v1/permissions
List all permissions in the system with optional filters
Permissions: 🔵 permissions.read
query Parameters
categoryFilter by category
searchSearch by key, name, or description
pageDefault: 1
limitDefault: 50
List permissions › Responses
Default Response
status​object
​object
Create permission
POST
https://common-api.karma.life
/api/v1/permissions
Create a new permission in the system
INTERNAL: Only accessible to specific Karmeleon user IDs
Permissions: 🟢 permissions.create
Create permission › Request Body
key^[a-z]+\.[a-z]+$ · requiredDot notation permission key (e.g., resource.action)
namedescriptioncategoryCreate permission › Responses
Default Response
status​object
​object
Update permission
PUT
https://common-api.karma.life
/api/v1/permissions/{id}
Delete permission
DELETE
https://common-api.karma.life
/api/v1/permissions/{id}
Delete a permission
INTERNAL: Only accessible to specific Karmeleon user IDs
Note: Cannot delete permissions in use by roles or users
Permissions: 🔴 permissions.delete
path Parameters
idPermission ID
Delete permission › Responses
Default Response
status​object
​object