Mega icon

Mega

Work with Mega API

Conversation → Get Many

AI-generated

Summary

Retrieve a paginated list of conversations filtered by assignee type, status, search query, inbox ID, team ID, and labels.

Inputs

  • Assignee Type — Filter conversations by who is assigned: all, assigned, me, or unassigned.
  • Status — Filter conversations by their status: all, open, pending, resolved, or snoozed.
  • Query — Search term to filter conversations by message content.
  • Inbox ID — Numeric ID of the inbox to filter conversations within.
  • Team ID — Numeric ID of the team to filter conversations within.
  • Labels — JSON array of labels to filter conversations by associated tags.
  • Page — Page number for paginating the list of conversations, defaulting to the first page.

Output shape

a paginated list of conversation items matching the filter criteria

Results are returned based on the provided filters and pagination page. Optional fields enable refined filtering but are not mandatory. The exact shape of each conversation item depends on the Mega API response.

Examples

Example 1: Retrieve first page of open conversations assigned to the current user in inbox 123 with label 'urgent'

Assignee Type='Me', Status='Open', Inbox ID=123, Labels=['urgent'], Page=1

Example 2: Search all pending conversations containing 'invoice' keyword

Status='Pending', Query='invoice', Assignee Type='All', Page=1

Links

Discussion