v2 - 2026-04-07 - Search filter restructuring

Search endpoints across entities, notes, members, and teams have been restructured with a new filter format.

Entities

Search entities deprecated flat filter properties in favor of a structured filter object.

• Deprecated type, types, ids, name, archived, parent, statuses, owners in favor of nested groups (filter.type, filter.id, filter.fields.*, filter.relationships.*)
• Deprecated top-level fields parameter; use return.fields array instead
• Added filter.createdAt and filter.updatedAt with from/to date range filtering

Notes

Search notes deprecated flat filter properties in favor of a structured filter object.

• Deprecated ids, archived, processed, owners, creators, source, metadata, createdAt, updatedAt, relationships at the top level in favor of nested groups (filter.type, filter.id, filter.fields.*, filter.metadata.*, filter.relationships.*)
• Added filter.metadata.source to filter by source system and record ID (e.g., system: "intercom")
• Added filter.createdAt and filter.updatedAt with from/to date range filtering
• Deprecated top-level fields query parameter; use return.fields array in the request body instead

Members

Search members deprecated flat filter properties in favor of a structured filter object.

• Deprecated ids, emails, roles, includeDisabled, includeInvitationPending, query at the top level in favor of filter.id, filter.fields.*, search.query, and return.*
• Added data.search.query for full-text search (case-insensitive partial match on name or email, requires members_pii:read scope)
• Added return.includeDisabled to include disabled members alongside active members in results (default false). Distinct from filter.fields.disabled, which exclusively returns only disabled members
• Added return.includeInvitationPending to include members with pending invitations alongside accepted members (default false). Distinct from filter.fields.invitationPending, which exclusively returns only pending members

Teams

Search teams deprecated flat filter properties in favor of a structured filter object.

• Deprecated ids, names, handles at the top level in favor of filter.id and filter.fields.*
• Added data.search.query for full-text search (case-insensitive partial match on team name or handle)

The legacy flat format continues to work but will be removed in a future version.