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

Depends On: VIEW_TRAVELERS (to see and select 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

Depends On: VIEW_BOOKINGS (to find bookings to cancel)

Cancellation may have financial implications including non-refundable charges and fees.

Scope Dependencies

Scope	Practical Prerequisites
`VIEW_TRAVELERS`	None
`MANAGE_TRAVELERS`	`VIEW_TRAVELERS` recommended
`CREATE_BOOKINGS`	`VIEW_TRAVELERS` required
`VIEW_BOOKINGS`	None
`CANCEL_BOOKINGS`	`VIEW_BOOKINGS` required

Default Scopes

When creating a delegation without explicitly specifying scopes, these defaults are applied:

Default Scopes
VIEW_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

Scopes Explained - Conceptual overview
Fields Reference - Delegation entity fields
API Reference - REST endpoints

Scopes Reference

On this page