Commentary · OAuth Scopes

Commentary OAuth Scopes

OAuth 2.0 searched

Commentary publishes 42 OAuth 2.0 scopes. Scopes are the fine-grained permissions an application requests at authorization time to act against the Commentary API on a user’s behalf.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

CompanyAI AgentsHuman-in-the-LoopCode ReviewDocument ReviewMarkdownPull RequestsMCPDeveloper ToolsCollaboration

Scopes: 42 Flows: Method: searched

Scopes (42)

Scope	Description	Flows
commentary.review.settings.write
commentary.agents.profile.write
commentary.review.read	Review reads
commentary.comments.read	Read review comments
commentary.comments.write	Write review comments
commentary.comments.status	Change comment status
commentary.review.share
commentary.draft_reviews.delete
commentary.draft_reviews.share
commentary.review.submit	Submit reviews
commentary.forms.read
commentary.forms.write
commentary.forms.submit
commentary.forms.writeback
commentary.research.read
commentary.research.write
commentary.brain.evals.read
commentary.brain.evals.write
commentary.interactions.create
commentary.interactions.read
commentary.interactions.update
commentary.interactions.cancel
commentary.interactions.fulfillment
commentary.inbox.read
commentary.workspaces.read
commentary.workspaces.resources.write
commentary.webhooks.read
commentary.webhooks.write
commentary.projects.read
commentary.projects.write
commentary.trackers.read
commentary.trackers.write
commentary.trackers.writeback
commentary.review_packages.read
commentary.review_packages.write
commentary.project_reviews.read
commentary.project_reviews.write
commentary.source_snapshots.read
commentary.source_snapshots.write
commentary.evidence.read
commentary.evidence.write
commentary.evidence.verify

📄 Provider scope reference: https://commentary.dev/docs/build/developer-access

Source

OAuth Scopes

generated: '2026-11-04'
method: searched
source: https://commentary.dev/.well-known/oauth-authorization-server
docs: https://commentary.dev/docs/build/developer-access
also:
- https://commentary.dev/docs/reference/schemas/external-scope
- https://commentary.dev/.well-known/oauth-protected-resource
note: The OpenAPI declares only an http bearer scheme (no oauth2 securityScheme); scopes are published in the OAuth authorization-server
  metadata and the ExternalScope schema. Scopes cannot be changed after a token is issued.
flows:
  grant_types:
  - authorization_code
  - refresh_token
  - urn:ietf:params:oauth:grant-type:device_code
  pkce:
  - S256
  token_endpoint_auth_methods:
  - none
  authorization_endpoint: https://commentary.dev/oauth/authorize
  token_endpoint: https://commentary.dev/oauth/token
  device_authorization_endpoint: https://commentary.dev/oauth/device/code
  registration_endpoint: https://commentary.dev/oauth/register
presets:
- Read reviews and comments
- Standard API and MCP
- Draft review automation
- Draft review deletion
- Review and submit
- Brain evaluations
targets:
- github:owner/repo
- github:owner/repo:pull:123
- github:owner/repo:branch:main
- draft:<sessionId>
scopes:
- name: commentary.review.settings.write
- name: commentary.agents.profile.write
- name: commentary.review.read
  description: Review reads
- name: commentary.comments.read
  description: Read review comments
- name: commentary.comments.write
  description: Write review comments
- name: commentary.comments.status
  description: Change comment status
- name: commentary.review.share
- name: commentary.draft_reviews.delete
- name: commentary.draft_reviews.share
- name: commentary.review.submit
  description: Submit reviews
- name: commentary.forms.read
- name: commentary.forms.write
- name: commentary.forms.submit
- name: commentary.forms.writeback
- name: commentary.research.read
- name: commentary.research.write
- name: commentary.brain.evals.read
- name: commentary.brain.evals.write
- name: commentary.interactions.create
- name: commentary.interactions.read
- name: commentary.interactions.update
- name: commentary.interactions.cancel
- name: commentary.interactions.fulfillment
- name: commentary.inbox.read
- name: commentary.workspaces.read
- name: commentary.workspaces.resources.write
- name: commentary.webhooks.read
- name: commentary.webhooks.write
- name: commentary.projects.read
- name: commentary.projects.write
- name: commentary.trackers.read
- name: commentary.trackers.write
- name: commentary.trackers.writeback
- name: commentary.review_packages.read
- name: commentary.review_packages.write
- name: commentary.project_reviews.read
- name: commentary.project_reviews.write
- name: commentary.source_snapshots.read
- name: commentary.source_snapshots.write
- name: commentary.evidence.read
- name: commentary.evidence.write
- name: commentary.evidence.verify

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This scope set

curl "https://apis.io/api/v1/scopes/commentary-dev-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.