DelegationReference
API Reference
Technical reference for delegation management
API Reference
This page provides a summary of delegation operations. For complete API documentation with request/response examples, contact your system administrator or refer to the developer documentation.
Available Operations
Admin Operations
Administrators with delegation permissions can perform the following operations:
| Operation | Description | Required Permission |
|---|---|---|
| List delegations | View all delegations with filtering and search | READ_DELEGATIONS |
| View delegation | View details of a specific delegation | READ_DELEGATIONS |
| Create delegation | Create new delegation between users | WRITE_DELEGATIONS |
| Update delegation | Modify scopes or status | WRITE_DELEGATIONS |
| Revoke delegation | Permanently delete a delegation | WRITE_DELEGATIONS |
Self-Service Operations
Users can manage their own delegations:
| Operation | Description |
|---|---|
| View delegations I granted | See who you've given access to |
| View delegations granted to me | See who has given you access |
| Grant access | Create a new delegation to another user |
| Update my delegation | Change scopes on delegations you created |
| Revoke my delegation | Remove a delegation you created |
Common Errors
| Error | Meaning | Solution |
|---|---|---|
| Cannot delegate to yourself | Delegator and delegate are the same | Select a different user |
| Delegation already exists | This user pair already has a delegation | Edit the existing delegation instead |
| User not active in company | One of the users is not an active company member | Verify both users are active |
| Forbidden | Insufficient permissions | Contact an administrator |
Related Topics
- Creating Delegations - Step-by-step guide
- Managing Delegations - Editing and updating
- Fields Reference - Field constraints