Documentation
Sign inGet started

bird email mailboxes list

Usage

Exemple de code
bird email mailboxes list [flags]

Description

List the workspace's mailboxes as a cursor page, newest first. Search addresses and display names with q, or filter by exact address, state, or domain.
Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.

Examples

Exemple de code
bird email mailboxes list
bird email mailboxes list | jq -r '.data[].id'
bird email mailboxes list --limit 50 --starting-after <cursor>

Options

Filters

NameDescription
--addressFilter to the mailbox with exactly this address.
--domainFilter to mailboxes whose address is on this domain.
--include-deletedInclude mailboxes deleted within their 30-day restore window. Defaults to false, so only active and suspended mailboxes are returned. Deleted mailboxes carry a non-null deleted_at.
--qCase-insensitive search matching the mailbox's address or display name (substring).
--response-schemaPrint the fields this command returns, then exit
--stateFilter by lifecycle state.

Pagination

NameDescription
--ending-beforeCursor from the prev_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order.
--limit <n>Maximum number of items to return per page.
--starting-afterCursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.
NameDescription
bird email mailboxes composeSend a new message from a mailbox
bird email mailboxes createCreate a mailbox
bird email mailboxes deleteDelete a mailbox
bird email mailboxes getGet a mailbox
bird email mailboxes labelsList a mailbox's labels
bird email mailboxes restoreRestore a deleted mailbox
bird email mailboxes resumeResume a suspended mailbox
bird email mailboxes statsMailbox email statistics
bird email mailboxes updateUpdate a mailbox