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 with the Write Own Delegations permission 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 (user-to-user delegations) |
| View delegated companies | See company-wide delegations granted to you |
| Search company users | Search for users within a company you have company-wide access to |
| 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 |
Company-wide delegations can only be created and revoked by administrators. Users can view company-wide delegations granted to them but cannot modify or revoke them through self-service.
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