Sort by fields. Example: sort=created_at:asc,updated_at:desc

Filter by recommendation lifecycle state: 'active', 'completed', 'dismissed', 'approved', or 'snoozed'.

Filter by target actor UID.

Filter by context UID.

Filter by category bucket. Each record belongs to one bucket only, checked in this order:
upcoming – due_at is in the future (based on time, even if the stored category is different).
fyi – due_at is not in the future and execution_policy is auto_execute (again, based on fields, not stored category).
needs_attention / opportunity – stored category is one of these, due_at is not in the future, and execution_policy is requires_human_approval.

Filter by the record's 'producer' (creation source). When omitted, only legacy records with an empty 'producer' are returned (default). Pass 'any' to return only records that have a non-empty 'producer', or pass a specific producer value (for example: 'client_agent') to return only records from that producer.

Which staff members' recommendations to return. 'my_view' (default) returns only the caller's own recommendations; 'team' returns recommendations across every staff member in the business, subject to the caller having permission to view other staff members' entities (e.g., "my_view", "team").