Skip to content

docs: add the subscribe a tenant to the pro plan api guide - #1507

Merged
simeng-li merged 3 commits into
masterfrom
simeng-log-14189-37-docs-automate-tenant-creation-page-endpoint-reference
Sep 30, 2026
Merged

simeng-li merged 3 commits into
masterfrom
simeng-log-14189-37-docs-automate-tenant-creation-page-endpoint-reference

Conversation

@simeng-li

Copy link
Copy Markdown
Contributor

Summary

Refs LOG-14189.

Draft: do not merge until the API is released. POST /api/tenants/{tenantId}/subscription is still behind the dev-features gate in Logto Cloud and answers 501 in production.

Adds a Logto Cloud guide for subscribing a tenant to the Pro plan through the Cloud API, the step after Automate tenant management.

What changed

  • docs/logto-cloud/subscribe-tenant-to-pro.mdx (new, right after "Automate tenant management" in the sidebar): prerequisites (PAT, tenant Admin, a billing account with a saved card, a production tenant on Free), the request with its Idempotency-Key header, 201 versus 200, how to retry safely (the same key never charges twice; a new key only after the attempt ended in an error; the 23-hour window), the error table with what to do for each code, and a create-and-subscribe script.
  • docs/logto-cloud/automate-tenant-creation.mdx: a tip after tenant creation and a related link, both pointing to the new page.
  • docs/logto-cloud/README.mdx: a card for the new page.

Reviewer notes

  • "Contact us to get one" for the PAT reflects today's staff-issued tokens; adjust if self-service issuance ships first.
  • The page carries no consent wording about charging the saved card without the cardholder present. Add it here if the terms owner wants a sentence.
  • Translations are left to the content-generation workflow.

Testing

N/A

Checklist

  • .changeset
  • unit tests
  • integration tests
  • necessary TSDoc comments

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 20, 2026 •

Copy link
Copy Markdown

Deploying logto-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2d85c6a
Status: ✅  Deploy successful!
Preview URL: https://0dcc22e5.logto-docs.pages.dev
Branch Preview URL: https://simeng-log-14189-37-docs-aut.logto-docs.pages.dev

View logs

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 20, 2026 •

Copy link
Copy Markdown

Deploying logto-docs-tutorials with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4780882
Status:⚡️  Build in progress...

View logs

@simeng-li
simeng-li requested review from a team, charIeszhao and wangsijie and removed request for a team September 28, 2026 06:58
@simeng-li
simeng-li marked this pull request as ready for review September 28, 2026 06:58
Comment thread docs/logto-cloud/automate-tenant-creation.mdx Outdated
* docs: choose the billing account for an api subscription

* docs: say a retry ignores the billing account it names

* docs: a retry must name the same billing account

* docs: say which billing account an omitted customerId charges
@simeng-li
simeng-li enabled auto-merge (squash) September 30, 2026 03:52
@simeng-li
simeng-li merged commit 04a04ae into master Sep 30, 2026
17 of 18 checks passed
@simeng-li
simeng-li deleted the simeng-log-14189-37-docs-automate-tenant-creation-page-endpoint-reference branch September 30, 2026 03:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants