Skip to content

Conversation

@jasoncabot
Copy link
Contributor

Please feel free to re-word / clarify the edits, I wanted to provide a bit more detail with the permissions.

Summary

It was implied that customers could scope down notification creation access to particular products. This isn't true at the current time.

A customer with account edit permissions can create any account level notification policy, similarly a token with "Account Settings: Edit" can create any kind of notification policy.

The restrictions on creation of policies depends on the products that an account is entitled to (e.g enterprise, business, professional or free).

I also clarified that webhooks are available to everyone with a paid service, for example if you pay for Cloudflare Workers you get webhooks.

Screenshots (optional)

n/a

Documentation checklist

It was implied that customers could scope down notification creation access to particular products. This isn't true at the current time.

A customer with account edit permissions can create any account level notification policy, similarly a token with "Account Settings: Edit" can create any kind of notification policy.

The restrictions on creation of policies depends on the products that an account is entitled to (e.g enterprise, business, professional or free).

I also clarified that webhooks are available to everyone with a paid service, for example if you pay for Cloudflare Workers you get webhooks.
@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Mar 12, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Clarified permissions related to notifications and webhooks in the documentation.

  • Specified that customers cannot scope down notification creation access to specific products.
  • Clarified that account edit permissions allow creation of any notification policy.
  • Indicated that webhook access is available to all paid service accounts.

Modified Files

  • src/content/docs/notifications/get-started/index.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@dcpena dcpena enabled auto-merge (squash) April 1, 2025 16:21
@dcpena dcpena merged commit a714bc8 into cloudflare:production Apr 1, 2025
6 checks passed
@workers-devprod workers-devprod added the contribution [Holopin] Recognizes a docs contribution, big or small label Apr 1, 2025
@holopin-bot
Copy link

holopin-bot bot commented Apr 1, 2025

Congratulations @jasoncabot, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cm8yr1owu00330cjoh3tuj5in

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!

RebeccaTamachiro pushed a commit that referenced this pull request Apr 21, 2025
* Clarify permissions for notifications and webhooks

It was implied that customers could scope down notification creation access to particular products. This isn't true at the current time.

A customer with account edit permissions can create any account level notification policy, similarly a token with "Account Settings: Edit" can create any kind of notification policy.

The restrictions on creation of policies depends on the products that an account is entitled to (e.g enterprise, business, professional or free).

I also clarified that webhooks are available to everyone with a paid service, for example if you pay for Cloudflare Workers you get webhooks.

* Small edit

---------

Co-authored-by: Denise Peña <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution [Holopin] Recognizes a docs contribution, big or small product:notifications size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants