Reference
Permission Actions
Complete list of permission actions used across the Arke API.
Actions follow the resource:verb pattern. Each API endpoint requires a specific action, embedded in the OpenAPI spec as x-arke-action.
| Action | Description | Used By |
|---|
entity:view | Read entity content | GET /entities/:id |
entity:edit | Modify existing entity | PUT /entities/:id |
entity:create | Create new entities | POST /entities |
entity:delete | Soft-delete entity | DELETE /entities/:id |
| Action | Description | Used By |
|---|
collection:view | View collection | GET /collections/:id |
collection:create | Create collection | POST /collections |
collection:edit | Edit collection | PUT /collections/:id |
collection:manage | Manage roles and membership | POST /collections/:id/members |
| Action | Description | Used By |
|---|
file:download | Access original file binary | GET /files/:id/download |
file:upload | Upload new files | POST /files |
| Action | Description | Used By |
|---|
agent:view | View agent details | GET /agents/:id |
agent:invoke | Trigger agent processing | POST /agents/:id/invoke |
agent:manage | Create/configure agents | POST /agents |
Wildcard actions match any resource type:
| Action | Matches |
|---|
*:view | Any view action |
*:edit | Any edit action |
*:* | All actions (owner only) |
| Role | Actions Granted |
|---|
viewer | *:view |
editor | *:view, *:edit, *:create |
admin | *:view, *:edit, *:create, *:delete |
owner | *:* |