Scopes Reference
Complete technical reference for delegation permission scopes
Scopes Reference
This page provides a complete technical reference for all delegation permission scopes in Rahal.
Available Scopes
Rahal provides five delegation scopes:
| Scope | Display Name |
|---|---|
| VIEW_TRAVELERS | View Travelers |
| MANAGE_TRAVELERS | Manage Travelers |
| CREATE_BOOKINGS | Create Bookings |
| VIEW_BOOKINGS | View Bookings |
| CANCEL_BOOKINGS | Cancel Bookings |
Scope Details
VIEW_TRAVELERS
| Property | Value |
|---|---|
| Constant | VIEW_TRAVELERS |
| Display Name | View Travelers |
| Description | Allows viewing the delegator's traveler profiles |
Grants Access To:
- Traveler list for the delegator
- Traveler profile details
- Traveler passport information
- Traveler contact details
- Traveler document list
Required For:
- Traveler selection during booking
- Viewing traveler profiles
MANAGE_TRAVELERS
| Property | Value |
|---|---|
| Constant | MANAGE_TRAVELERS |
| Display Name | Manage Travelers |
| Description | Allows modifying the delegator's traveler profiles |
Grants Access To:
- Create new travelers for the delegator
- Edit existing traveler profiles
- Update passport information
- Upload and manage documents
- Delete travelers
Required For:
- Adding travelers for the delegator
- Updating traveler information
- Managing traveler documents
CREATE_BOOKINGS
| Property | Value |
|---|---|
| Constant | CREATE_BOOKINGS |
| Display Name | Create Bookings |
| Description | Allows creating new bookings for the delegator's travelers |
Grants Access To:
- Search for flights and hotels
- Select delegated travelers
- Create booking requests
- Complete booking flow
Required For:
- Making new bookings for delegated travelers
- Submitting booking requests
Automatically Includes: VIEW_TRAVELERS + MANAGE_TRAVELERS
VIEW_BOOKINGS
| Property | Value |
|---|---|
| Constant | VIEW_BOOKINGS |
| Display Name | View Bookings |
| Description | Allows viewing bookings for the delegator's travelers |
Grants Access To:
- Booking history for delegated travelers
- Booking details and itineraries
- Booking confirmation information
- Booking status
Required For:
- Viewing past and upcoming bookings
- Accessing booking confirmations
CANCEL_BOOKINGS
| Property | Value |
|---|---|
| Constant | CANCEL_BOOKINGS |
| Display Name | Cancel Bookings |
| Description | Allows cancelling bookings for the delegator's travelers |
Grants Access To:
- Request booking cancellation
- Initiate refund processes (where applicable)
Required For:
- Cancelling upcoming bookings
- Modifying travel plans
Automatically Includes: VIEW_BOOKINGS
Cancellation may have financial implications including non-refundable charges and fees.
Scope Dependencies
| Scope | Automatically Includes |
|---|---|
VIEW_TRAVELERS | None |
MANAGE_TRAVELERS | VIEW_TRAVELERS |
CREATE_BOOKINGS | VIEW_TRAVELERS + MANAGE_TRAVELERS |
VIEW_BOOKINGS | None |
CANCEL_BOOKINGS | VIEW_BOOKINGS |
Default Scopes
When creating a delegation without specifying scopes, these defaults are applied:
| Default Scopes (as selected) |
|---|
| VIEW_TRAVELERS |
| CREATE_BOOKINGS |
| VIEW_BOOKINGS |
After auto-normalization, CREATE_BOOKINGS adds MANAGE_TRAVELERS, so the effective defaults are: VIEW_TRAVELERS, MANAGE_TRAVELERS, CREATE_BOOKINGS, VIEW_BOOKINGS.
Scope Presets
| Preset | Scopes Included | Use Case |
|---|---|---|
| Full Access | View Travelers, Manage Travelers, Create Bookings, View Bookings, Cancel Bookings | Executive assistants with complete control |
| Booking Only | View Travelers, Create Bookings, View Bookings | Standard assistant access for booking travel |
| View Only | View Travelers, View Bookings | Managers who need visibility without modification |
| Traveler Manager | View Travelers, Manage Travelers | HR staff maintaining traveler profiles |
Scope Enforcement
Scopes are enforced when a delegate attempts an action:
- System checks for an active delegation between delegator and delegate
- System verifies the delegation includes the required scope
- If both pass, the action is allowed
- If either fails, access is denied
Related Topics
- Scopes Explained - Conceptual overview
- Fields Reference - Delegation entity fields
- API Reference - REST endpoints