Skip to content

docs: sync API reference with latest OpenAPI spec#45

Merged
sandervanhooft merged 1 commit into
mainfrom
claude/great-bun-732bb5
Jul 4, 2026
Merged

docs: sync API reference with latest OpenAPI spec#45
sandervanhooft merged 1 commit into
mainfrom
claude/great-bun-732bb5

Conversation

@sandervanhooft

Copy link
Copy Markdown
Member

Summary

Syncs the docs to the latest Vatly OpenAPI spec (sandervanhooft/vatlify@main) and closes the last public PSP leak. One PR covering both the additive sync and the removal.

Adopted spec changes

  • Customers — new name identity field (resource + examples), documented PATCH /customers/{id}.
  • Subscriptions — recurring price updates via the update API.
  • Webhook Endpoints — new REST resource; adds content/2.api-reference/10.webhook-endpoints.md (list/create/get/update/delete) plus a pointer from the Webhooks guide.
  • Webhookssubscription.updated and subscription.update_scheduled events, incl. the object.scheduledUpdate payload.

PSP-leak removal

  • Removes the simulate-failure test helper from the docs, following its deletion upstream in sandervanhooft/vatlify#1777. It was the only public API surface exposing a provider-native mandated-payment ID (mollie_mandated_payment_…, and adyen_… once Adyen ships). The bundled spec now has zero mollie/adyen tokens.

Verification

  • markdownlint clean on all changed pages
  • sitemap regenerated (new webhook-endpoints page included)
  • no remaining references to the removed endpoint in content or spec

Follow-up (separate repos)

SDKs (vatly-api-php, vatly-laravel) still need: customer name + update(), subscription price, the Webhook Endpoints resource, the two new events, and removal of the simulate-failure helper method. Not touched here.

Adopt all vatlify OpenAPI changes since the last sync:

- Customers: add `name` identity field + document PATCH /customers/{id}
- Subscriptions: document recurring `price` updates via the update API
- Webhook Endpoints: new REST resource page (CRUD) + guide pointer
- Webhooks: add subscription.updated and subscription.update_scheduled
  events and the scheduledUpdate payload
- Remove the simulate-failure test helper (deleted upstream in
  sandervanhooft/vatlify#1777) — it was the only public API surface
  exposing a provider-native mandated-payment ID

Regenerate sitemap; refresh public/openapi.yaml.
@sandervanhooft sandervanhooft merged commit d83d0ed into main Jul 4, 2026
2 checks passed
@sandervanhooft sandervanhooft deleted the claude/great-bun-732bb5 branch July 4, 2026 22:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant