Discard or restore people, in bulk
Mark people not a fit, or bring them back, in one call instead of looping per person. Max 500 people per request. To discard named or picked people, set update.lifecycleStage to "rejected" (optionally with update.qualificationNotes explaining why) — discarding is reversible, it never deletes the contact, and the row still shows up in the list marked as not a fit. To undo a named not-a-fit mark, set update.lifecycleStage to "contact". A described rule is not a write: peek then propose with filter_contacts intent:"discard" or exceptContactIds. The write lands on this conversation's own list; you never need to name one.
Query parameters
Scopes the write to one list. Omit it: a chat turn writes to the list of the conversation it is in.
Scopes the write to one list. Omit it: a chat turn writes to the list of the conversation it is in.
Request body
Response
Bulk update results