/{connector_id}/list_updated_accounts

Retrieve accounts that have been updated since a specified point in time.

This operation enables efficient account synchronization by allowing clients to fetch only accounts that have been modified since their last sync. This is particularly useful for maintaining up-to-date account information across large user bases without having to fetch all accounts on every request.

Use Cases

• Account Synchronization: Keep local account databases in sync with the remote system's current state
• Audit Trails: Track account changes for compliance and security purposes
• Real-time Updates: Monitor account modifications for immediate action
• Data Migration: Identify accounts that need to be updated during system migrations or upgrades

Delta Query Support

This operation supports delta queries for incremental synchronization:

• Initial Request: Provide a since to get all accounts updated since that time
• Subsequent Requests: Use the cursor from the previous response for efficient incremental updates
• Cursor Management: Each response includes a new cursor for the next request

Account Update Detection

Different connectors may define "updates" differently based on their capabilities:

• Profile information changes (name, email, department, etc.)
• Permission or role modifications
• Account status changes (active/inactive, suspended, etc.)
• Custom attribute modifications
• Group membership changes

Rate Limiting Considerations

• Implement exponential backoff for repeated requests
• Consider batching requests for large account populations
• Monitor API rate limits specific to each connector