List interviews

Returns a paginated list of interviews (and general meetings) filtered by person, project, status bucket, type, and start date range. Each item includes the linked candidate (for interview-type rows), organizer, participants, and quick existence flags for transcript, manual notes, and AI notes.

Incremental sync: startDate / endDate bound the scheduled time and are not a sync cursor. Use createdAfter (with createdBefore) for the initial historical backfill, then poll with updatedAfter: persist the highest updatedAt you receive and pass it back on the next poll. updatedAfter matches a change to either the interview or its underlying meeting, and the reported updatedAt is the later of the two. Re-send the cursor with a small overlap (e.g. a minute earlier than the highest updatedAt seen) and de-duplicate by id, so a row written mid-page is never skipped. Add includeDeleted=true to receive soft-deleted interviews as tombstones (deletedAt populated) — combined with updatedAfter this reliably surfaces deletions, because a soft-delete bumps updatedAt.

Custom attributes: pass includeCustomAttributes=true to get each row’s customAttributes (e.g. the meeting tags logged in the UI) inline, in the detail endpoint’s shape, instead of fetching each record by id. customAttributeIds limits which attributes come back. The payload grows with each row’s filled attributes, so keep the default pageSize (25) when syncing with it on. Setting, changing or removing an attribute value moves the row’s updatedAt, so updatedAfter polling picks the change up.