notifications

1ctl notifications manages the in-platform notifications Satusky sends for events that need your attention: low credit balance, deployment failures, domain verification results, certificate issues, and security alerts.

Alias: 1ctl notif

Notifications are delivered in two ways depending on severity. Standard notifications land in the platform’s notification feed (what these commands read). Critical alerts — low balance, security events — are also sent via email through Satusky’s email delivery service. The CLI commands operate on the notification feed only.

Commands

`1ctl notifications list`

1ctl notifications list [--unread] [--limit <n>]

Lists notifications in reverse-chronological order. By default returns up to 20, including both read and unread.

Flags

Flag	Default	Description
`--unread`	false	Show only unread notifications.
`--limit <n>`	`20`	Number of notifications to return.

# All recent notifications
1ctl notifications list

# Only unread
1ctl notifications list --unread

# Last 50 notifications
1ctl notifications list --limit 50

Example output:

ID           UNREAD  TYPE                  MESSAGE                                    RECEIVED
notif_abc1   ●       deployment.failed     api-server deploy failed: OOMKilled        5m ago
notif_abc2   ●       credits.low           Organization balance below $10             2h ago
notif_abc3           domain.verified       api.acme.com verified successfully         1d ago
notif_abc4           cert.issued           TLS certificate issued for api.acme.com    1d ago

`1ctl notifications count`

1ctl notifications count

Returns the count of unread notifications. Useful for scripting and status bar integrations.

$ 1ctl notifications count
3 unread notifications

`1ctl notifications read`

1ctl notifications read [--id <id>] [--all]

Marks one or all notifications as read. Exactly one of --id or --all is required.

Flags

Flag	Description
`--id <id>`	Mark a specific notification as read.
`--all`	Mark all notifications as read.

# Mark one notification as read
1ctl notifications read --id notif_abc1

# Clear all unread
1ctl notifications read --all

`1ctl notifications delete`

1ctl notifications delete --id <id>

Deletes a notification permanently. Use this to clean up noise after you’ve dealt with an alert.

Flags

Flag	Description
`--id <id>`	required — ID of the notification to delete.

1ctl notifications delete --id notif_abc4

Notification types

Type	Meaning
`deployment.failed`	A deployment rollout failed. Check `1ctl deploy status` for events.
`deployment.succeeded`	A deployment completed successfully (only sent for `--wait` deployments).
`credits.low`	Your organization’s credit balance has fallen below the warning threshold.
`credits.exhausted`	Credit balance is zero. New deployments are blocked until credits are added.
`domain.verified`	A domain you added has passed DNS verification.
`domain.failed`	DNS verification failed. Check your DNS records.
`cert.issued`	A TLS certificate was provisioned for a domain.
`cert.expiring`	A certificate is expiring and auto-renewal has not yet succeeded.
`security.token_used_from_new_ip`	An API token was used from an IP address it has not been seen from before.