Get Favorites

GET

/org/{tenant}/v2/contacts/favorites

Platform support: MT and CC

Returns the user's favorite contacts list with a sync timestamp for delta polling.

Delta sync: Pass the since query parameter with the last-known updated_at value. If the server's timestamp matches, the response omits favorites (no changes). Otherwise the full list is returned.

Request

Responses

200

Favorites list with sync timestamp.

304

Not Modified (client since matches server stamp; list is unchanged).

400

Bad request — the request was invalid (validation error, malformed body, or missing/invalid parameters).

401

Unauthorized — missing or invalid identity, or insufficient permissions.

500

Internal Server Error — an unexpected error occurred.