Search all skrzynka documentation

Invocation#

text

skrzynka mailbox list

Purpose#

List the mailboxes Skarbiec declares, after reading the vault.

Inputs and options#

Input or option	Required	Meaning
None	No	This command has no command-specific inputs or options.

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#

Reads which Skarbiec items carry skrzynka:mailbox, creates a mailbox for each newly declared item, adopts profile changes of declared ones, marks mailboxes whose item lost the tag enabled:false with MAILBOX_NOT_DECLARED, and prints a JSON array of public mailbox objects sorted case-insensitively by display name and then by email. It does not contact a mail provider.

Refusals#

SKARBIEC_UNAVAILABLE, SKARBIEC_TIMEOUT, or SKARBIEC_RESPONSE_INVALID when the vault cannot be listed. Database failure returns INTERNAL_ERROR with the actual underlying database operation error.
Metadata listing preserves the selected Skarbiec executable, child exit status or signal, and original stderr. Malformed JSON or a malformed item record is SKARBIEC_RESPONSE_INVALID with the decoder cause; invalid ids, tag lists or tag members are not silently removed from the inventory. Reconciliation therefore cannot interpret a partial malformed response as withdrawn mailbox declarations.