docs: remove POST /api/notifications (superseded by /api/emails)

Merged
SW
4mo ago
+4-142

Removes the POST /api/notifications contract as part of the chat#1815 cleanup (decided 2026-06-25). Docs-first — the recoupable/api route + handler deletion follows, and the recoupable/cli notifications command re-points to /api/emails.

Why

/api/notifications was the earlier placeholder that emails the account's own address. With to now optional on POST /api/emails (defaulting to the account's own email — docs#252 / api#710), /api/emails fully subsumes it. Two endpoints over the same ground is dead surface area; we standardize on /api/emails.

What changed (pure removal + one link fix)

  • api-reference/openapi/accounts.json: removed the /api/notifications path and the CreateNotificationRequest + NotificationResponse schemas (128 deletions, 0 additions; JSON validated).
  • docs.json: removed the Notifications nav group.
  • api-reference/notifications/create.mdx: deleted.
  • cli.mdx: re-pointed the notifications command reference link from /api/notifications → /api/emails (the CLI command is re-pointed in a sibling cli PR).

Sequencing

Lands before close of chat#1815, and after /api/emails to-optional is live so the self-send default is available. CLI re-point + api deletion are sibling PRs.

🤖 Generated with Claude Code

Summary by cubic

Removed the POST /api/notifications docs and OpenAPI path. Standardized on POST /api/emails (defaults to the account email when to is omitted) and renamed the CLI docs section and examples to emails.

  • Refactors

    • Deleted /api/notifications path and the CreateNotificationRequest and NotificationResponse schemas from api-reference/openapi/accounts.json.
    • Removed the Notifications nav group and reference page.
    • Updated cli.mdx to point to POST /api/emails and renamed the section header and examples to use recoup emails.

  • Migration

    • Replace POST /api/notifications calls with POST /api/emails; omit to to send to the account’s email.