bird email threads search
Usage
Code example
bird email threads search <q> [flags]Description
Full-text search across every mailbox in the workspace, ranked by relevance. Matches a conversation's message subjects, body text, and sender and recipient addresses, and returns the matching threads with highlighted subject or body fragments when available.
Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.
Examples
Code example
bird email threads search <q>
bird email threads search <q> | jq -r '.data[].id'
bird email threads search <q> --limit 50 --starting-after <cursor>Options
Filters
| Name | Description |
|---|---|
--after | Match only conversations with a matching message received at or after this time. Use the response cursors for pagination. |
--before | Match only conversations with a matching message received at or before this time. Use the response cursors for pagination. |
--folder | Filter to a folder. Omit to search across eligible folders. Possible values: inbox, archive, spam, blocked, sent, trash. |
--labels <value>… | Match every listed custom label. Repeat labels to supply more than one. System label names are refused. |
--mailbox-id | Restrict the search to a mailbox by ID or email address in this workspace. An unknown or ambiguous email address returns 404; a valid mailbox ID with no matching threads returns an empty page. |
--read-state | Filter to read or unread conversations. Omit for either state. Possible values: read, unread. |
--response-schema | Print the fields this command returns, then exit |
Pagination
| Name | Description |
|---|---|
--ending-before | Cursor from the prev_cursor or refresh_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev_cursor returns the preceding page. refresh_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since. |
--limit <n> | Maximum number of items to return per page. Allowed range: 1 to 100. |
--starting-after | Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order. |
Related
| Name | Description |
|---|---|
bird email threads delete | Delete a thread |
bird email threads get | Get a thread |
bird email threads list | List threads |
bird email threads restore | Restore a thread from trash |
bird email threads update | Update a thread |
Related resources
Continue with the documentation, guides and examples for this topic.