Update threads in bulk

• Authorization

  string

  header

  required

  Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

• external_ids

  string[]

  Caller-owned identifiers. Replaces the full set.

• text

  string
• title

  string | null
• pain_level

  enum<string>
  One of:

  UNKNOWN

  LOW

  MEDIUM

  HIGH
• assignee_id

  string | null

  Workspace user id. Pass null to unassign.

• contact_id

  string
• company_id

  string | null

  Pass null to detach. Also propagates onto the thread's contact.

• tag_ids

  string[]

  Replaces the thread's full tag set.

• project_id

  string | null
• status

  enum<string>

  When snoozed, snoozed_until is required.

  One of:

  open

  snoozed

  done
• snoozed_until

  string<date-time>
• closed_loop

  boolean

  With status=done, marks the thread as fully closed.

• ai_draft_html

  string | null

  HTML body prefilled into the composer for the next outbound reply. Setting this stamps ai_draft_generated_at and clears ai_draft_started_at + ai_draft_error_at. Pass null (or an empty string) to clear the draft.

• ai_draft_sources

  any[] | null

  Sources the AI consulted while generating the draft. Surfaces in the composer's "Drafted by AI" tooltip. Shape: { type, title, identifier?, url? }[]. Pass null to clear.

• clear_ai_draft_error

  boolean

  When true, clears ai_draft_error_at. Use this to dismiss a stuck error pill in the composer without writing a new draft.

• notify

  object

  Side-channel notifications to fire alongside the write (Slack and/or email).

  Show fields
• ids

  string[]

  required

  Thread ids, at most 100. The whole batch counts as one write against the rate limit.

Successful response

• updated

  string[]

  required
• failed

  object[]

  required
  Show fields