API · SDK · runtime · authentication lifecycle intelligence

Last updated · 9 September 2026

SchemaTrace

Breaking changes, enforcement dates and migration requirements.

ST-2026-208 · Authentication & identity

Cloudflare OAuth clients gain optional scopes at General Availability

Cloudflare made Optional OAuth Scopes generally available on 20 August 2026, allowing OAuth client owners to classify configured scopes as required or optional and allowing users to decline optional scopes during consent.

CloudflareOAuthscopesconsentleast privilege

Previous state

Configured OAuth client scopes were presented through an all-or-nothing consent boundary once requested; users could not selectively decline a subset of requested scopes during the consent step.

Current state

OAuth client owners can mark configured scopes as optional, while required scopes remain mandatory. Users can decline optional scopes on the consent screen; optional scopes are selected by default and all configured scopes remain required by default unless reclassified.

Who needs to care

Developers and administrators configuring Cloudflare OAuth clients, and users authorizing those applications.

What to do

Review configured client scopes, mark only genuinely optional permissions as optional, and ensure applications tolerate a narrower granted scope set instead of assuming every requested optional scope was approved.

What the source does not prove

The source proves General Availability of optional scope classification and partial consent. It does not make existing required scopes optional automatically, and it does not mean every configured scope is shown in every authorization flow.

Lifecycle history

Dated event sequence

  1. Optional OAuth Scopes become generally available

    Cloudflare announced required-versus-optional client scope classification and user-selectable optional consent.

Evidence ledger

First-party sources

  1. 01
    Cloudflare — Optional OAuth scopes

    Official Cloudflare changelog · 2026-08-20

    Open official source ↗