Search all skrzynka documentation

Invocation#

text

skrzynka message outbound [--mailbox <MAILBOX>] [--limit <LIMIT>] [--offset <OFFSET>]

Purpose#

List the outbound messages this installation originated, newest first.

Inputs and options#

Input or option	Required	Meaning
`--mailbox <MAILBOX>`	No	Mailbox UUID or the mailbox's own address. Omit it to list every mailbox in the local CLI organization.
`--limit <LIMIT>`	No	Messages per page; without it every message from `--offset` on is listed. `0` is refused with `LIMIT_INVALID`: limit must be at least one; omit it to list every message.
`--offset <OFFSET>`	No	Unsigned pagination offset; default `0`.

Global options accepted on this path are --organization <ID> (required on every command except serve, version and onboarding; none is assumed), --skarbiec-bin <PATH> (default skarbiec) and --text (print results as path: value lines for people instead of JSON).

Output and state effect#

Prints a JSON array of stored outbound messages ordered by creation time, newest first. Each row carries its mailbox ID, idempotency key, recipients, cc, subject, body, delivery status, optional provider message ID, and optional error code and message. It resolves no credential and contacts no provider; an empty database prints [].

Refusals#

Negative numbers or values outside Clap's u32 parser are refused before dispatch with exit 2.
--mailbox is resolved before listing, so NOT_FOUND: mailbox was not found and MAILBOX_SELECTOR_AMBIGUOUS: <SELECTOR> names <COUNT> mailboxes (<ID>, <ID>); select one by id both apply here; INVALID_IDENTIFIER is not raised because a non-UUID selector is treated as an address.