Skip to content
Browse documentationNotifications

Notifications commands

Signatures, flags and examples for recala notifications.

Use these commands

Examples assume you have signed in and selected the intended organization. Set shell variables such as ARTICLE_ID to ids from the corresponding list command. Set PUBLICATION_TIME to a future local time in YYYY-MM-DDTHH:MM format.

Badges describe the command’s strongest effect; a preview or read-only option may do less. Guarded writes can require confirmation even without --yes. “Needs a person” covers identity, consent and credentials.

recala notifications list

Unread notifications, newest first.

read Acts on an organization
recala notifications list [OPTIONS]
Signature

Replace [OPTIONS] with the flags you need, or omit it.

FlagRequiredDescription
--jsonNoPrint one JSON document (errors as JSON on stderr).
--orgNoCompany name, slug or id (else RECALA_ORG, else recala company use).

Examples

Set the named shell variables to your own values before running.

recala notifications list

Exit codes 0 OK 1 ERROR 2 USAGE 3 NOT_AUTHENTICATED 4 FORBIDDEN 5 NOT_FOUND 6 CONFLICT 7 INVALID 8 RATE_LIMITED 9 UNAVAILABLE 11 PAYMENT_REQUIRED

API commands share the CLI’s HTTP error mapping. Read human and JSON output rules.

recala notifications read

Mark one notification (by its 8-character id) or all of them as read.

writes Acts on an organization
recala notifications read NOTIFICATION_ID [OPTIONS]
Signature

Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.

FlagRequiredDescription
--jsonNoPrint one JSON document (errors as JSON on stderr).
--orgNoCompany name, slug or id (else RECALA_ORG, else recala company use).
--allNoMark every unread notification as read.
--dry-runNoSay what would be marked without marking it.

Examples

Set the named shell variables to your own values before running.

recala notifications read "$NOTIFICATION_ID"

Exit codes 0 OK 1 ERROR 2 USAGE 3 NOT_AUTHENTICATED 4 FORBIDDEN 5 NOT_FOUND 6 CONFLICT 7 INVALID 8 RATE_LIMITED 9 UNAVAILABLE 10 CONFIRMATION_REQUIRED 11 PAYMENT_REQUIRED

API commands share the CLI’s HTTP error mapping. Read human and JSON output rules.

CLI reference
Search documentation