Permissions API

Manage allow/ask/deny permission rules.

Endpoints

List Rules

GET /api/v1/permissions?project_path={path}

Response:

{
  "rules": [
    { "id": "abc123", "type": "allow", "pattern": "Bash(npm run *)", "scope": "user" }
  ],
  "settings": {
    "defaultMode": "default",
    "additionalDirectories": [],
    "disableBypassPermissionsMode": false
  }
}

Get Rules by Scope

GET /api/v1/permissions/scope/{scope}?project_path={path}

Add Rule

POST /api/v1/permissions?project_path={path}

{ "type": "allow", "pattern": "Bash(npm run *)", "scope": "user" }

Update Rule

PUT /api/v1/permissions/{rule_id}?scope={scope}&project_path={path}

{ "type": "deny", "pattern": "Write(*.env)" }

Delete Rule

DELETE /api/v1/permissions/{rule_id}?scope={scope}&project_path={path}

Update Settings

PUT /api/v1/permissions/settings?scope={scope}&project_path={path}

{
  "defaultMode": "conservative",
  "additionalDirectories": ["/tmp/workspace"],
  "disableBypassPermissionsMode": true
}