> For the complete documentation index, see [llms.txt](https://islamu.gitbook.io/islamu-event/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://islamu.gitbook.io/islamu-event/documentation/readme/administration-and-branding/admin-hierarchy.md).

# Admin Hierarchy

Delegate instance, tenant, organization, and group administration without widening authority.

Administration in ISLAMU Event is strictly scoped. Having administrative permissions at one level does not automatically grant authority across higher scopes or global platform concerns.

***

## Administrative Scopes

| Scope            | Typical Responsibilities                                                                                                                                                                                                                                                                  | Dedicated Console             |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **Instance**     | Deployment-wide governance, [tenant provisioning](/islamu-event/documentation/readme/security-and-identity/multi-tenancy.md), provider posture, platform policies, and [monetization fee policies](/islamu-event/documentation/readme/events-and-ticketing/paid-events-and-payouts.md).   | `/admin/instance`             |
| **Tenant**       | Community policies, public storefront experience, lookups, navigation, footers, templates, [custom properties](/islamu-event/documentation/readme/events-and-ticketing/custom-properties.md), and [delegated storage](/islamu-event/documentation/readme/integrations-and-ai/storage.md). | `/settings/admin`             |
| **Organization** | Organization profile, membership approvals, verified organizer status, and scoped API keys.                                                                                                                                                                                               | `/settings/organization/{id}` |
| **Group**        | Sub-community or chapter profiles, public event listings, and group branding.                                                                                                                                                                                                             | `/settings/group/{id}`        |

> \[!NOTE] Instance console routes are active primarily in [Multi-Tenant Deployments](/islamu-event/documentation/readme/security-and-identity/multi-tenancy.md). Tenant administrators govern local tenant participation and settings; they possess no authority to mutate global User, Actor, or Organization records.

***

## Action Authority & HAL Affordances

Every mutable action follows current **HAL `_links`** (see [Authorization Affordance Gating](/islamu-event/documentation/readme/security-and-identity/authorization.md#the-golden-rule-of-client-ui-affordances)):

* The UI never renders "Purge", "Revoke", "Edit", or "Delete" buttons based on client-side role inspection alone.
* If a tenant is suspended or an event is finalized, the server omits the action link and the button disappears automatically.
* Concurrency and version conflicts are intentional safety signals: reload the current entity rather than force-overwriting state.

***

## High-Impact Operations & Audit Checklist

Record operator ownership, preconditions, and recovery paths before executing:

* Tenant purge scheduling or restoration.
* Production API key revocation.
* Switching between [Local RBAC and Cerbos PDP](/islamu-event/documentation/readme/security-and-identity/authorization.md).
* Bulk [custom property retirement](/islamu-event/documentation/readme/events-and-ticketing/custom-properties.md).
* Updating platform monetization fee structures.

***

## Related Guides & Next Steps

* [**Administration Web Walkthrough**](/islamu-event/documentation/readme/administration-and-branding/admin-guide.md) — Step-by-step navigation of all admin screens.
* [**Authorization & Access Control**](/islamu-event/documentation/readme/security-and-identity/authorization.md) — Understand policy enforcement and fail-closed gates.
* [**Multi-Tenancy Architecture**](/islamu-event/documentation/readme/security-and-identity/multi-tenancy.md) — Review tenant boundary enforcement and query filters.
* [**White-Labeling & Branding**](/islamu-event/documentation/readme/administration-and-branding/white-labeling.md) — Configure tenant styling tokens and governance locks.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://islamu.gitbook.io/islamu-event/documentation/readme/administration-and-branding/admin-hierarchy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.