Notifications actions

15 actions. Each action calls the same API route with the same scopes on every surface.

notifications_done_block_reminder

Mark a block reminder as done.

Route	POST /api/v1/notifications/inbox/{id}/reminder/done
Tool name	calternal_api_notifications_done_block_reminder
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

query

Field	Type	Required	Description
operation_id	string	no

calternal action run notifications_done_block_reminder --input '{"path":{"id":"<id>"}}' --confirm --json

notifications_get_quiet_hours

Get quiet hours.

Route	GET /api/v1/notifications/settings/quiet-hours
Tool name	calternal_api_notifications_get_quiet_hours
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request none, response json

calternal action run notifications_get_quiet_hours --input '{}' --json

notifications_inbox_delete

Delete an inbox item.

Route	DELETE /api/v1/notifications/inbox/{id}
Tool name	calternal_api_notifications_inbox_delete
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

query

Field	Type	Required	Description
operation_id	string	no

calternal action run notifications_inbox_delete --input '{"path":{"id":"<id>"}}' --confirm --json

notifications_inbox_get

Get one inbox notice.

Route	GET /api/v1/notifications/inbox/{id}
Tool name	calternal_api_notifications_inbox_get
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run notifications_inbox_get --input '{"path":{"id":"<id>"}}' --json

notifications_inbox_list

List Notifications inbox items Continuation: Pass next_cursor unchanged. Reduce limit after an overflow..

Route	GET /api/v1/notifications/inbox
Tool name	calternal_api_notifications_inbox_list
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request none, response json

query

Field	Type	Required	Description
cursor	string	no
limit	integer, int32 (0–)	no

calternal action run notifications_inbox_list --input '{}' --json

notifications_inbox_mark_all_read

Mark inbox items as read.

Route	PUT /api/v1/notifications/inbox/read
Tool name	calternal_api_notifications_inbox_mark_all_read
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request none, response json

query

Field	Type	Required	Description
until_ms	integer, int64	no

calternal action run notifications_inbox_mark_all_read --input '{}' --confirm --json

notifications_inbox_mark_read

Mark an inbox item as read.

Route	PUT /api/v1/notifications/inbox/{id}/read
Tool name	calternal_api_notifications_inbox_mark_read
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run notifications_inbox_mark_read --input '{"path":{"id":"<id>"}}' --confirm --json

notifications_inbox_mutation_receipt

Reconcile an inbox action under the authenticated User’s receipt scope..

Route	GET /api/v1/notifications/inbox/mutations/{id}
Tool name	calternal_api_notifications_inbox_mutation_receipt
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run notifications_inbox_mutation_receipt --input '{"path":{"id":"<id>"}}' --json

notifications_preview_block_reminder

Preview block reminder delivery. Body fields: audience, instant, note_id..

Route	POST /api/v1/notifications/reminders/preview
Tool name	calternal_api_notifications_preview_block_reminder
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request json, response json

body

Field	Type	Required	Description
audience	string	yes	everyone or only_me.
instant	string	yes	Absolute trigger time as a bounded RFC 3339 instant.
note_id	string	yes	Stable Note ID owned by the authenticated User.

calternal action run notifications_preview_block_reminder --input '{}' --json

notifications_set_quiet_hours

Set quiet hours. Body fields: quiet_end, quiet_start..

Route	PUT /api/v1/notifications/settings/quiet-hours
Tool name	calternal_api_notifications_set_quiet_hours
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
quiet_end	string	yes	Local wall-clock end in 24-hour HH:MM form.
quiet_start	string	yes	Local wall-clock start in 24-hour HH:MM form.

calternal action run notifications_set_quiet_hours --input '{}' --confirm --json

notifications_snooze_block_reminder

Snooze a block reminder. Body fields: minutes..

Route	POST /api/v1/notifications/inbox/{id}/reminder/snooze
Tool name	calternal_api_notifications_snooze_block_reminder
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request json, response json

path

Field	Type	Required	Description
id	string	yes

query

Field	Type	Required	Description
operation_id	string	no

body

Field	Type	Required	Description
minutes	integer, int32 (0–)	yes	Minutes from now, from 1 minute to 7 days.

calternal action run notifications_snooze_block_reminder --input '{"path":{"id":"<id>"}}' --confirm --json

notifications_subscribe

Register a push subscription. Body fields: installation_id, subscription..

Route	POST /api/v1/notifications/subscriptions
Tool name	calternal_api_notifications_subscribe
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
installation_id	string	yes	Stable random ID for one browser or app Installation.
subscription	object	yes	Browser Push API subscription fields.

calternal action run notifications_subscribe --input '{}' --confirm --json

notifications_undo_inbox_mutation

Undo one receipt; the inverse is read and consumed inside one writer transaction.. Body fields: operation_id..

Route	POST /api/v1/notifications/inbox/mutations/{id}/undo
Tool name	calternal_api_notifications_undo_inbox_mutation
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request json, response json

path

Field	Type	Required	Description
id	string	yes

body

Field	Type	Required	Description
operation_id	string	yes	Fresh operation ID for this Undo attempt.

calternal action run notifications_undo_inbox_mutation --input '{"path":{"id":"<id>"}}' --confirm --json

notifications_unsubscribe

Remove a push subscription.

Route	DELETE /api/v1/notifications/subscriptions/{installation_id}
Tool name	calternal_api_notifications_unsubscribe
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
installation_id	string	yes

calternal action run notifications_unsubscribe --input '{"path":{"installation_id":"<installation_id>"}}' --confirm --json

notifications_vapid_public_key

Get the push public key.

Route	GET /api/v1/notifications/vapid/public-key
Tool name	calternal_api_notifications_vapid_public_key
Surfaces	cli, mcp, webmcp
Scopes	data, account
Effect	read only
Encoding	request none, response json

calternal action run notifications_vapid_public_key --input '{}' --json