Permissions

Manage role permissions

Permissions control what actions roles can perform on collections.

List Permissions

GET /permissions

Example:

curl "https://your-directus-instance.com/permissions" \
  -H "Authorization: Bearer YOUR_TOKEN"

Get Permission

GET /permissions/:id

Create Permission

POST /permissions

Request Body:

{
  "role": "role-uuid",
  "collection": "articles",
  "action": "read",
  "permissions": {
    "status": {
      "_eq": "published"
    }
  },
  "fields": ["*"]
}

Permission Actions

• create - Create new items
• read - Read items
• update - Update items
• delete - Delete items
• share - Share items

Update Permission

PATCH /permissions/:id

Delete Permission

DELETE /permissions/:id

Permission Properties

id · integer

Permission ID

role · string

Role UUID (null for public)

collection · string

Collection name

action · string

Permission action

permissions · object

Filter rules (null for all items)

validation · object

Validation rules

fields · array

Allowed fields

Next Steps

Roles

Manage roles

Users

Manage users