Find and filter conversations for any workflow.

This operation retrieves conversations from your DevRev workspace using optional filters and returns matching conversation IDs and a total count for use in automated workflows.

This operation lists conversations from your DevRev workspace and returns the results as workflow outputs. Add it to any workflow where you need to look up conversations by tags, state, stage, ownership, or other criteria, then pass the matching IDs to downstream steps.

Features

  • Flexible Filtering Filter conversations by tags, state, stages, members, owners, parts, spam status, and verified creator status. Combine multiple filters to narrow results to exactly the conversations your workflow needs.
  • Custom Filter Support Pass additional filter criteria as JSON to support advanced queries such as last external message date ranges, source channels, and custom fields. Structured inputs are applied first, with JSON filters overriding on matching keys.
  • Automatic Pagination Automatically paginates through large result sets using cursor-based iteration. Returns up to 1,000 conversations per run, with a configurable default of 50.
  • Workflow-Ready Outputs Returns a list of matching conversation IDs and a total count, ready to feed into subsequent workflow steps such as assignment, tagging, or bulk updates.