Skip to content

fix: add read:confluence-content.summary to required scopes#78

Merged
pchuri merged 1 commit intomainfrom
claude/gracious-mestorf
Mar 14, 2026
Merged

fix: add read:confluence-content.summary to required scopes#78
pchuri merged 1 commit intomainfrom
claude/gracious-mestorf

Conversation

@pchuri
Copy link
Owner

@pchuri pchuri commented Mar 14, 2026

Description

Add missing read:confluence-content.summary scope to documentation and 401 error hints. This scope is required for reading content but was not listed, causing 401 errors for users with scoped API tokens.

Reported by @Anigif in #76 (post-fix comment).

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Documentation update

Testing

  • Tests pass locally with my changes (144 passed)
  • New and existing unit tests pass locally with my changes

Checklist

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings

Files Changed

  • README.md — added scope to table and read-only minimum list
  • lib/confluence-client.js — added scope to 401 error hint message
  • .claude/skills/confluence/SKILL.md — added scope to read-only list

…tion

The read:confluence-content.summary scope is required for reading content
but was missing from docs and error hints. Reported by user in #76.

Closes #76
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds the missing read:confluence-content.summary scope to user-facing documentation and the scoped-token 401 troubleshooting hint, reducing confusion and preventing 401s for users using least-privilege scoped API tokens.

Changes:

  • Document read:confluence-content.summary as a required classic scope for reading content metadata/summaries.
  • Update the minimum “read-only” scope set to include read:confluence-content.summary.
  • Extend the 401 unauthorized hint in the Confluence client to mention the additional required scope.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
lib/confluence-client.js Updates 401 scoped-token hint to include read:confluence-content.summary in the example scope list.
README.md Adds the missing scope to the scoped-token scope table and to the read-only minimum scope list.
.claude/skills/confluence/SKILL.md Updates the read-only scoped-token scope list to include read:confluence-content.summary.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@pchuri pchuri merged commit 9f7b70a into main Mar 14, 2026
10 checks passed
github-actions bot pushed a commit that referenced this pull request Mar 14, 2026
## [1.27.3](v1.27.2...v1.27.3) (2026-03-14)

### Bug Fixes

* add read:confluence-content.summary to required scopes documentation ([#78](#78)) ([9f7b70a](9f7b70a)), closes [#76](#76) [#76](#76)
@github-actions
Copy link

🎉 This PR is included in version 1.27.3 🎉

The release is available on:

Your semantic-release bot 📦🚀

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants