[IAM] deprecate account role api

[robotdan]

Summary

Deprecate the Account Role API.
No EOL yet.
ACCT-12238

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.
• If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
• Files which have changed name or location have been allocated redirects.

[AdamBouhmad]

Looks great! Made some small comments, but otherwise LGTM

[cloudflare-docs-bot]

Review

✅ No issues found in commit fa463a7.

Code Review

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

_{No code review issues found.}

Conventions

_{No convention issues found.}

Style Guide Review

_{No style-guide issues found.}

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.
/disable-auto-review	Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase	Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

[robotdan]

CR-819784033e41 · Invalid CSS calc expression

• N/A. This looks to be an existing issue in the repo, or due to the agent reviewing changes from a rebase?

CR-b7390274715d · Case-insensitive search only lowercases query

• N/A. This looks to be an existing issue in the repo, or due to the agent reviewing changes from a rebase?

CR-7752e64d977b · Content mismatch with PR title

• N/A. This looks to be a comment from a previous change to the repo, perhaps due to the agent reviewing changes from a rebase?

CR-a4a459bb14fc · Conflicting Tailwind position utilities

• N/A. This looks to be an existing issue in the repo, or due to the agent reviewing changes from a rebase?

[KaydeeDee]

This should be on https://developers.cloudflare.com/fundamentals/api/reference/deprecations/ for folks to reference the deprecation

[robotdan]

This should be on https://developers.cloudflare.com/fundamentals/api/reference/deprecations/ for folks to reference the deprecation

Thanks @KaydeeDee!

I think the change I have in src/content/release-notes/api-deprecations.yaml‎ will end up on the deprecations page under fundamentals once built. I have confirmed with a local build. But let me know if I missed something!

Separately, still waiting on some internal copy review.

[AdamBouhmad]

LGTM. thanks daniel

[jhutchings1]

Disabled auto-merge to allow time to resolve the comments. Overall, seems fine and I don't mind approving in advance.

[jhutchings1]

Approve with pending comments

[mgirouard]

We should also mention the affected terraform resource: cloudflare_account_role and that users are expected to use the new cloudflare_account_permission_group resource.

[robotdan]

I added this so the "Additional notes" below. If you prefer I add it as a top level section - happy to do that as well. But there was no prior art in this file for a top level terraform mention alongside the API, so I kept it as a note.