P
PUGUH

Permissions Reference

Complete reference for all permissions in ARSAKA PUGUH.

Permission Format

All permissions follow this pattern:

plaintext
{domain}.{resource}.{action}

IAM Domain

PermissionDescription
iam.users.viewView user list and details
iam.users.inviteInvite new users to organization
iam.users.updateUpdate user details
iam.users.suspendSuspend/activate users
iam.users.removeRemove users from organization
iam.roles.viewView roles and permissions
iam.roles.createCreate custom roles
iam.roles.updateModify role permissions
iam.roles.deleteDelete custom roles
iam.service-accounts.viewView service accounts
iam.service-accounts.createCreate service accounts
iam.service-accounts.deleteDelete service accounts
iam.service-accounts.rotateRotate API keys

Organization Domain

PermissionDescription
organization.settings.viewView organization settings
organization.settings.updateUpdate organization settings
organization.members.viewView member list
organization.members.manageAdd/remove members
organization.applications.viewView applications
organization.applications.createCreate new applications
organization.applications.updateUpdate application settings
organization.applications.deleteDelete applications
organization.deleteDelete the entire organization

Webhook Domain

PermissionDescription
webhook.endpoints.viewView webhook endpoints
webhook.endpoints.createCreate webhook endpoints
webhook.endpoints.updateUpdate webhook configuration
webhook.endpoints.deleteDelete webhook endpoints
webhook.endpoints.testSend test ping to webhook
webhook.deliveries.viewView delivery history
webhook.deliveries.retryRetry failed deliveries

Storage Domain

PermissionDescription
storage.files.viewView and download files
storage.files.uploadUpload new files
storage.files.deleteDelete files
storage.buckets.viewView storage buckets
storage.buckets.createCreate storage buckets
storage.buckets.deleteDelete storage buckets

Control Domain

PermissionDescription
control.audit.viewView audit trails
control.audit.exportExport audit logs
control.events.viewView event timeline
control.events.detailView event details
control.metrics.viewView system metrics
control.dlq.viewView dead letter queue
control.dlq.retryRetry failed events
control.dlq.dismissDismiss DLQ items

Billing Domain

PermissionDescription
billing.subscription.viewView current subscription
billing.subscription.updateChange subscription plan
billing.invoices.viewView invoice history
billing.invoices.downloadDownload invoices
billing.payment-methods.viewView payment methods
billing.payment-methods.updateUpdate payment methods

Role Permission Mapping

Owner (All Permissions)

Has all permissions in all domains.

Admin

plaintext
iam.users.*
iam.roles.*
iam.service-accounts.*
organization.settings.*
organization.members.*
organization.applications.*
webhook.*
storage.*
control.*

Excludes:

  • organization.delete
  • billing.*

Member

plaintext
iam.users.view
iam.roles.view
iam.service-accounts.view
organization.settings.view
organization.members.view
organization.applications.view
webhook.endpoints.*
webhook.deliveries.view
storage.files.view
storage.files.upload
control.audit.view
control.events.view
control.metrics.view

Viewer

plaintext
iam.users.view
iam.roles.view
organization.settings.view
organization.members.view
organization.applications.view
webhook.endpoints.view
webhook.deliveries.view
storage.files.view
control.audit.view
control.events.view
control.metrics.view

Checking Permissions

In the Dashboard

Navigate to IAM > Permissions to see:

  • Your effective permissions
  • Comparison across roles
  • Missing permissions for specific actions

Via API

javascript
// Check single permission
const result = await client.checkPermission('webhook.endpoints.create');
// { allowed: true }

// Check multiple permissions
const results = await client.checkPermissions([
  'webhook.endpoints.create',
  'webhook.endpoints.delete',
  'storage.files.upload'
]);
// {
//   'webhook.endpoints.create': true,
//   'webhook.endpoints.delete': false,
//   'storage.files.upload': true
// }

// Get all permissions
const allPermissions = await client.getMyPermissions();
// ['webhook.endpoints.view', 'webhook.endpoints.create', ...]

Permission Errors

When a permission check fails, you'll see:

Dashboard:

"You don't have permission to perform this action."

API:

json
{
  "detail": "Missing permission: webhook.endpoints.delete"
}

Related