DelegationReference
Reference Overview
Quick reference for delegation features
Delegation Reference
This section provides quick-reference documentation for delegation features.
Reference Topics
Scopes Reference
Complete list of delegation scopes with technical details
Fields Reference
All delegation entity fields and their constraints
API Reference
REST API endpoints for delegation management
Quick Reference
Delegation Types
| Type | Description |
|---|---|
| User-to-User | Grants access between two specific users |
| Company-wide | Grants access to all (or selected) users' travelers in a company |
Delegation Scopes
| Scope | Constant | Description |
|---|---|---|
| View Travelers | VIEW_TRAVELERS | See traveler profiles |
| Manage Travelers | MANAGE_TRAVELERS | Edit traveler profiles |
| Create Bookings | CREATE_BOOKINGS | Make new bookings |
| View Bookings | VIEW_BOOKINGS | See booking history |
| Cancel Bookings | CANCEL_BOOKINGS | Cancel existing bookings |
Common Scope Presets
| Preset | Scopes |
|---|---|
| Full Access | VIEW_TRAVELERS, MANAGE_TRAVELERS, CREATE_BOOKINGS, VIEW_BOOKINGS, CANCEL_BOOKINGS |
| Booking Only | VIEW_TRAVELERS, CREATE_BOOKINGS, VIEW_BOOKINGS |
| View Only | VIEW_TRAVELERS, VIEW_BOOKINGS |
| Traveler Manager | VIEW_TRAVELERS, MANAGE_TRAVELERS |
Default Scopes
When creating a delegation without specifying scopes, the system applies the Booking Only preset: View Travelers, Create Bookings, and View Bookings.
Delegation Status
| Status | Value | Effect |
|---|---|---|
| Active | true | Delegation is enforced |
| Inactive | false | Delegation is paused |
Required Permissions
| Action | Required Permission |
|---|---|
| View delegations | Read Delegations |
| Create delegations | Write Delegations |
| Update delegations | Write Delegations |
| Revoke delegations | Write Delegations |
| Self-service delegation management | Write Own Delegations |
Error Codes
| Code | Message | Cause |
|---|---|---|
DELEGATION_REVOKED | Access revoked | Delegation deleted or deactivated |
SCOPE_INSUFFICIENT | Missing permission | Delegation lacks required scope |
TRAVELER_INACCESSIBLE | Traveler unavailable | Delegation or traveler removed |