Skip to content

Update OpenAPI 3.1 Descriptions - #7417

Open
github-openapi-bot wants to merge 1 commit into
mainfrom
openapi-update-e0e1175fddbff7927d41227b59b2317e22448e42286616d994b976e6e96202cd
Open

github-openapi-bot wants to merge 1 commit into
mainfrom
openapi-update-e0e1175fddbff7927d41227b59b2317e22448e42286616d994b976e6e96202cd

Conversation

@github-openapi-bot

Copy link
Copy Markdown
Collaborator

👋 humans. This PR updates the OpenAPI 3.1 description with the latest changes. ✨

Copilot AI auto review requested due to automatic review settings November 4, 2026 19:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

Copilot was unable to run its full agentic suite in this review.

Copilot review overview

No open issues 🎉

What changed in this PR

Updates the OpenAPI 3.1 descriptions to reflect recent REST API behavior and authorization documentation changes, including additional notification filtering and updated Copilot cloud agent access requirements.

Changes:

  • Add an is_done boolean query parameter to notification listing endpoints.
  • Update Copilot cloud agent organization endpoints’ descriptions to reflect custom org roles and adjust required scopes from admin:org to read:org.
  • Propagate these updates across versioned and dereferenced JSON/YAML artifacts.
File Description
descriptions-next/​api.github.com/​dereferenced/​api.github.com.deref.json Adds is_done parameter and updates Copilot endpoint descriptions in dereferenced JSON.
descriptions-next/​api.github.com/​dereferenced/​api.github.com.2026-03-10.deref.yaml Adds is_done parameter and updates Copilot description/scope in dereferenced YAML (2026-03-10).
descriptions-next/​api.github.com/​dereferenced/​api.github.com.2026-03-10.deref.json Adds is_done parameter and updates Copilot description/scope in dereferenced JSON (2026-03-10).
descriptions-next/​api.github.com/​dereferenced/​api.github.com.2022-11-28.deref.yaml Adds is_done parameter and updates Copilot description/scope in dereferenced YAML (2022-11-28).
descriptions-next/​api.github.com/​dereferenced/​api.github.com.2022-11-28.deref.json Adds is_done parameter and updates Copilot description/scope in dereferenced JSON (2022-11-28).
descriptions-next/​api.github.com/​api.github.com.yaml Adds is_done to canonical OpenAPI YAML paths and updates Copilot descriptions/scope.
descriptions-next/​api.github.com/​api.github.com.json Mirrors canonical changes in OpenAPI JSON.
descriptions-next/​api.github.com/​api.github.com.2026-03-10.yaml Applies canonical changes to the 2026-03-10 versioned YAML.
descriptions-next/​api.github.com/​api.github.com.2026-03-10.json Applies canonical changes to the 2026-03-10 versioned JSON.
descriptions-next/​api.github.com/​api.github.com.2022-11-28.yaml Applies canonical changes to the 2022-11-28 versioned YAML.
descriptions-next/​api.github.com/​api.github.com.2022-11-28.json Applies canonical changes to the 2022-11-28 versioned JSON.

Review effort: Lite (auto)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants