Document how platforms can provision temporary accounts on behalf of users + changelog by irvinebroque · Pull Request #31603 · cloudflare/cloudflare-docs

irvinebroque · 2026-06-21T01:49:06Z

Summary

Document how platforms can provision temporary accounts on behalf of users
Add changelog for ^

Documentation checklist

Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
The change adheres to the documentation style guide.

cloudflare-docs-bot · 2026-06-21T01:49:12Z

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review. To permanently lift the limit for this PR, a codeowner can comment /ignore-review-limit.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.

⚠️ 1 warning, 💡 1 suggestion found in commit f5c4bbc.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

✅ No code review issues found.

Style Guide Review

Warnings (1)

File	Issue
`changelog/workers/2026-06-22-temporary-accounts-api.mdx` line 50	Number and unit spacing — `60 minutes` Fix: Ensure correct spacing (already `60 minutes`). No issue.

Suggestions (1)

File	Issue
`changelog/workers/2026-06-22-temporary-accounts-api.mdx` line 52	Link phrasing — Uses `refer to [Claim deployments (temporary accounts)](...)` and `refer to [Temporary accounts for AI agent deployments](...)` Fix: Verify phrasing matches preferred `refer to [Page Title](/path/)` form; currently acceptable.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
`/review`	Runs a review now. Incremental if a prior review exists, full if not.
`/full-review`	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
`/ignore-review-limit`	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.

github-actions · 2026-06-21T01:49:50Z

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
`/src/content/changelog/`	`@cloudflare/pm-changelogs`, `@cloudflare/product-owners`
`/src/content/docs/cloudflare-for-platforms/`	`@irvinebroque`, `@dinasaur404`, `@cloudflare/product-owners`
`/src/content/docs/workers/`	`@cloudflare/workers-docs`, `@GregBrimble`, `@irvinebroque`, `@mikenomitch`, `@korinne`, `@WalshyDev`, `@cloudflare/deploy-config`, `@cloudflare/product-owners`, `@cloudflare/wrangler`, `@MattieTK`, `@cloudflare/dev-plat-leads`, `@vy-ton`

ask-bonk

This PR documents the REST API flow for temporary preview accounts, including a proof-of-work challenge, Node.js solver example, and deployment instructions. It also adds a corresponding changelog entry.

1 suggestion:

MEDIUM — : The curl block uses brace placeholders (, , ). Per the style guide, API curl examples must use shell variable format ().

Nit (non-blocking):

Consider adding a prefix to the PR title to match commit conventions (e.g., ).

ask-bonk

This PR documents the REST API flow for temporary preview accounts, including a proof-of-work challenge, Node.js solver example, and deployment instructions. It also adds a corresponding changelog entry.

1 suggestion to address before merge:

MEDIUM — claim-deployments.mdx:275-277: The curl block uses brace placeholders ({account_id}, {script_name}, {api_token}). Per the style guide, API curl examples must use shell variable format ($VARIABLE_NAME).

Nit (non-blocking):

Consider adding a [Workers] prefix to the PR title to match commit conventions (for example, [Workers] Document temporary account REST API provisioning + changelog).

ask-bonk · 2026-06-21T01:59:43Z

Review complete for PR #31603.

Summary of changes
This PR adds a new "Use the REST API directly" section to the Claim deployments (temporary accounts) page, documenting how platforms can provision temporary preview accounts via the Cloudflare REST API without Wrangler. It includes a sequence diagram, proof-of-work challenge flow, a Node.js solver example, and API deployment instructions. It also adds a corresponding changelog entry under src/content/changelog/workers/2026-06-22-temporary-accounts-api.mdx.

Actions taken

Applied labels: documentation, product:workers
Posted a review comment with summary and issue list
Posted an inline suggestion on claim-deployments.mdx:275-277

Issues flagged

MEDIUM — claim-deployments.mdx:275-277: The curl example uses brace placeholders ({account_id}, {script_name}, {api_token}). The style guide requires shell variable format ($VARIABLE_NAME) in API curl blocks. I posted an inline suggestion to fix this.
LOW (nit) — PR title could use a [Workers] prefix to match commit conventions (for example, [Workers] Document temporary account REST API provisioning + changelog).

No build-breaking issues, broken links, or frontmatter errors were found. The changelog entry is well-written and follows the required format.

github run

irvinebroque · 2026-06-21T02:07:09Z

/bonk address all feedback

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk · 2026-06-21T02:13:42Z

Done. Addressed all feedback on PR #31603:

Shell variable format in curl example — Changed {account_id}, {script_name}, and {api_token} to $ACCOUNT_ID, $SCRIPT_NAME, and $CLOUDFLARE_API_TOKEN in the Workers Script Upload API curl block.
Input validation in solvePreviewChallenge example — Added validation before the loop to match the documented bounds:
- seed decodes to exactly 32 bytes
- k and g are positive integers
- k * g <= 64_000_000

All validation passed (pnpm run check, pnpm run lint, pnpm run format:core:check).

github run

github-actions · 2026-06-21T02:16:12Z

Preview URL: https://49241f77.preview.developers.cloudflare.com
Preview Branch URL: https://docs-claim-deployments-rest-api.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/workers/platform/claim-deployments/	https://docs-claim-deployments-rest-api.preview.developers.cloudflare.com/workers/platform/claim-deployments/
https://developers.cloudflare.com/changelog/post/2026-06-22-temporary-accounts-api/	https://docs-claim-deployments-rest-api.preview.developers.cloudflare.com/changelog/post/2026-06-22-temporary-accounts-api/
https://developers.cloudflare.com/cloudflare-for-platforms/	https://docs-claim-deployments-rest-api.preview.developers.cloudflare.com/cloudflare-for-platforms/

irvinebroque · 2026-06-22T18:52:46Z

/bonk make @dinasaur404 a codeowner of relevant files touched in this PR, so that moving forward she can approve. Please do this and make a new, separate PR for this change to codeowners

ask-bonk · 2026-06-22T18:57:44Z

Done. I created a new branch (codeowners/add-dinasaur404-workers) and updated /.github/CODEOWNERS with two additions so @dinasaur404 can approve PRs touching the Workers paths affected in PR #31603:

/src/content/changelog/workers/
Covers the changelog/workers/ directory, which includes the new changelog entry (2026-06-22-temporary-accounts-api.mdx) added in PR Document how platforms can provision temporary accounts on behalf of users + changelog #31603.
/src/content/docs/workers/platform/
Covers the workers/platform/ docs directory, which includes the updated claim-deployments.mdx page.

The third file touched in PR #31603 (src/content/docs/cloudflare-for-platforms/index.mdx) was already covered by her existing ownership of /src/content/docs/cloudflare-for-platforms/.

github run

irvinebroque · 2026-06-25T14:42:33Z

/bonk update changelog to tomorrow (Friday, Jun 26)

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk · 2026-06-25T14:44:33Z

Done. Updated the changelog entry in PR #31603:

Renamed 2026-06-22-temporary-accounts-api.mdx → 2026-06-26-temporary-accounts-api.mdx
Updated frontmatter date: from 2026-06-22 to 2026-06-26

No other files in the PR reference the old June 22 date, so this is the only change needed.

github run

irvinebroque added 6 commits June 20, 2026 18:29

[Workers] Document claim deployments REST API

073adde

[Workers] Restore temporary deploy description

2182ae1

[Workers] Reorder claim deployments API flow

87dc123

[Workers] Remove REST API related card

ad7b2b5

[Workers] Add temporary accounts API changelog

47b6923

[Workers] Clarify temporary accounts API changelog

278f9e9

irvinebroque requested review from a team, GregBrimble, MattieTK, WalshyDev, korinne and vy-ton as code owners June 21, 2026 01:49

github-actions Bot added product:workers Related to Workers product product:changelog labels Jun 21, 2026

irvinebroque changed the title ~~Docs/claim deployments rest api~~ Document how platforms can provision temporary accounts on behalf of users + changelog Jun 21, 2026

github-actions Bot added the size/m label Jun 21, 2026

github-actions Bot assigned GregBrimble, korinne, MattieTK, vy-ton and WalshyDev Jun 21, 2026

ask-bonk Bot added the documentation Documentation edits label Jun 21, 2026

ask-bonk Bot reviewed Jun 21, 2026

View reviewed changes

Comment thread src/content/docs/workers/platform/claim-deployments.mdx Outdated

ask-bonk Bot reviewed Jun 21, 2026

View reviewed changes

Comment thread src/content/docs/workers/platform/claim-deployments.mdx Outdated

Fixed curl placeholders and added PoW validation.

f5c4bbc

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

[Cloudflare for Platforms] Add temporary accounts cross-link

7fe6ba5

irvinebroque requested a review from dinasaur404 as a code owner June 21, 2026 02:23

irvinebroque added 3 commits June 20, 2026 19:25

[Workers] Clarify temporary account API flow

4a86690

[Workers] Remove temporary account challenge diagram

b0afc49

[Workers] Document temporary account Wrangler handoff

49241f7

dinasaur404 approved these changes Jun 22, 2026

View reviewed changes

yomna-shousha approved these changes Jun 22, 2026

View reviewed changes

Updated changelog date to June 26.

bc93aa1

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

Uh oh!

Conversation

irvinebroque commented Jun 21, 2026

Summary

Documentation checklist

Uh oh!

cloudflare-docs-bot Bot commented Jun 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review

Code Review

Style Guide Review

Uh oh!

github-actions Bot commented Jun 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ask-bonk Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ask-bonk Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ask-bonk Bot commented Jun 21, 2026

Uh oh!

irvinebroque commented Jun 21, 2026

Uh oh!

ask-bonk Bot commented Jun 21, 2026

Uh oh!

github-actions Bot commented Jun 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

irvinebroque commented Jun 22, 2026

Uh oh!

ask-bonk Bot commented Jun 22, 2026

Uh oh!

irvinebroque commented Jun 25, 2026

Uh oh!

ask-bonk Bot commented Jun 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

cloudflare-docs-bot Bot commented Jun 21, 2026 •

edited

Loading

github-actions Bot commented Jun 21, 2026 •

edited

Loading

github-actions Bot commented Jun 21, 2026 •

edited

Loading