🚀 [Feature]: Manage Atlassian Confluence Cloud from PowerShell

[Marius Storhaug (MariusStorhaug)]

Confluence is now a working PowerShell module: connect to an Atlassian Confluence Cloud site once and manage pages, spaces, blog posts, folders, comments, labels, content properties, attachments, and restrictions as first-class PowerShell commands. This first version ports the generalized Confluence REST v2 client into the PSModule source layout and wires it to the Process-PSModule build.

New: 41 Confluence commands

Grouped by resource area:

• Auth — Connect-Confluence, Disconnect-Confluence, Get-ConfluenceContext
• Config — Get-ConfluenceConfig, Set-ConfluenceConfig
• API — Invoke-ConfluenceRestMethod (the single generic REST entry point every command wraps)
• Spaces — Get-ConfluenceSpace, Get-ConfluenceSpacePermission, Get-ConfluenceSpaceProperty, plus space administration: New-ConfluenceSpace (create), Update-ConfluenceSpace (partial update), Set-ConfluenceSpace (declarative create-or-replace), Remove-ConfluenceSpace (permanent, asynchronous delete)
• Site / Pages / BlogPosts / Folders / Comments / Labels / ContentProperties / Attachments / Restrictions / Users — read/write commands per area; page edits use Update-ConfluencePage (renamed from Set-ConfluencePage, since it performs a partial update and the Set verb is reserved for declarative create-or-replace as in Set-ConfluenceSpace)

Each command documents its required OAuth granular scope in its help, and errors surface Atlassian's X-Failure-Category (for example FAILURE_CLIENT_SCOPE_CHECK) so permission/scope failures are easy to spot. Every command's help links to its documentation page (https://psmodule.io/Confluence/Functions/<Area>/<Command>/) followed by the relevant Atlassian API reference.

New: reusable connections via Context

Credentials and module configuration persist through the Context module, declared via #Requires so the build records it as a manifest dependency. Connect once — the token is stored as a SecureString. Store multiple sites or accounts as named contexts and target any of them with -Context.

$token = Read-Host -AsSecureString
Connect-Confluence -ApiBaseUri 'https://api.atlassian.com/ex/confluence/<cloudId>' -Username 'you@example.com' -Token $token -SpaceKey 'DOCS'
$space = Get-ConfluenceSpace -Key 'DOCS'
New-ConfluencePage -SpaceId $space.id -Title 'Release notes' -Body '<p>Hello</p>'

How it is built

• One function per file under src/functions/{public,private}, grouped by resource area; module state in src/variables/private.
• No header.ps1 and no source manifest.psd1 — the build generates the manifest, derives the module tags from the repository topics, and reads the #Requires (PowerShell 7.0 and Context) from the source.
• Comment-based help follows the GitHub module style: indented sections, fenced examples, and a documentation-page .LINK first.
• Examples (Connecting, Pages) and a credential-free surface test, plus a skipped integration scaffold that reads CONFLUENCE_* environment secrets. Tests require Pester 6.x.

Tests and secrets

No tenant-specific data is included — examples use generic placeholders. The integration tests are skipped unless connection details are provided through repository environment secrets (CONFLUENCE_API_BASE_URI, CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN, CONFLUENCE_SPACE_KEY), which will be wired up in a follow-up. Until then, each public function carries a #SkipTest:FunctionTest marker so the framework's source-code test suite passes while per-function tests are deferred.

Technical details

• Merged main: kept the implemented-module README over the placeholder (📖 [Docs]: README pages now use the standard module landing-page format #15), adopted the Pester 6.x requirement (⚙️ [Maintenance]: Require Pester 6.x in test files #16), and picked up the Process-PSModule workflow bump to v5.5.7 (Bump PSModule/Process-PSModule/.github/workflows/workflow.yml from 5.4.6 to 5.5.7 #14).
• Validated locally: 0 syntax parse errors, 0 PSScriptAnalyzer findings (repo linter and framework build rules), every public command's first .LINK resolves to its docs page, and the module assembles and imports with all 41 public functions.
• Change type is minor (new functionality on a pre-1.0.0 module). Repository topics set to supply the manifest tags; major/minor/patch/NoRelease labels created for the release automation.
• No linked issue — this work was driven directly; a tracking issue can be added for traceability. Opened as a draft for review.

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL

�[32;1mRuleName                           �[0m�[32;1m Severity    �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m--------                           �[0m �[32;1m--------    �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSUseDeclaredVarsMoreThanAssignment Warning      Pages.ps1  25    The variable
s                                                                 'child' is as
                                                                  signed but ne
                                                                  ver used.


�[32;1mRuleName                           �[0m�[32;1m Severity    �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m--------                           �[0m �[32;1m--------    �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSAvoidLongLines                    Warning      Confluence 73    Line exceeds
                                                 .Tests.ps1       the configure
                                                                  d maximum len
                                                                  gth of 150 ch
                                                                  aracters
PSAvoidUsingConvertToSecureStringWi Error        Confluence 72    File 'Conflue
thPlainText                                      .Tests.ps1       nce.Tests.ps1
                                                                  ' uses Conver
                                                                  tTo-SecureStr
                                                                  ing with plai
                                                                  ntext. This w
                                                                  ill expose se
                                                                  cure informat
                                                                  ion. Encrypte
                                                                  d standard st
                                                                  rings should
                                                                  be used inste
                                                                  ad.

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

This PR turns the repository into a functional Confluence Cloud PowerShell module, adding a context-backed connection model plus a generic REST invoker and a first set of resource cmdlets, with updated docs/examples and CI wiring.

Changes:

• Adds Invoke-ConfluenceRestMethod as the core Confluence REST wrapper, plus Context-based connect/disconnect/config helpers.
• Introduces public cmdlets across key Confluence resources (spaces, pages, folders, comments, labels, attachments, restrictions, etc.) and supporting private helpers/state.
• Replaces placeholder scaffolding with real docs/examples, scopes documentation, a surface/integration test scaffold, and updated workflow secret/test-data handling.

Reviewed changes

Copilot reviewed 55 out of 55 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
tests/PSModuleTest.Tests.ps1	Removes scaffold “hello world” test.
tests/Confluence.Tests.ps1	Adds module surface tests and skipped integration scaffold driven by env vars.
src/variables/private/Confluence.ps1	Introduces module state (vault name, API path map, default config).
src/scripts/loader.ps1	Removes placeholder loader output.
src/init/initializer.ps1	Removes placeholder initializer output.
src/header.ps1	Removes placeholder header stub.
src/functions/public/Users/Get-ConfluenceCurrentUser.ps1	Adds cmdlet to resolve current authenticated user via v1 endpoint.
src/functions/public/Spaces/Get-ConfluenceSpaceProperty.ps1	Adds cmdlet to list/get space properties.
src/functions/public/Spaces/Get-ConfluenceSpacePermission.ps1	Adds cmdlet to list space permission assignments.
src/functions/public/Spaces/Get-ConfluenceSpace.ps1	Adds cmdlet to fetch a space by key/id with default context fallback.
src/functions/public/Site/Get-ConfluenceSiteInfo.ps1	Adds cmdlet to return cloudId + browsable site URL probe.
src/functions/public/Site/Get-ConfluenceCloudId.ps1	Adds cmdlet to resolve cloudId via public tenant_info endpoint.
src/functions/public/Restrictions/Get-ConfluenceRestriction.ps1	Adds cmdlet to read page restrictions via v1 endpoint.
src/functions/public/Pages/Set-ConfluencePage.ps1	Adds cmdlet to update a page (read current, increment version, PUT).
src/functions/public/Pages/Remove-ConfluencePage.ps1	Adds cmdlet to trash/purge pages with optional recursive deletion of children.
src/functions/public/Pages/New-ConfluencePage.ps1	Adds cmdlet to create pages (optionally under a parent).
src/functions/public/Pages/Get-ConfluencePageVersion.ps1	Adds cmdlet to list page version history.
src/functions/public/Pages/Get-ConfluencePageChild.ps1	Adds cmdlet to list direct child pages.
src/functions/public/Pages/Get-ConfluencePage.ps1	Adds cmdlet to fetch a page with requested body format.
src/functions/public/Pages/Get-ConfluenceDescendant.ps1	Adds cmdlet to list descendants with automatic pagination.
src/functions/public/Labels/Remove-ConfluenceLabel.ps1	Adds cmdlet to remove a label from a page via v1 endpoint.
src/functions/public/Labels/Get-ConfluenceLabel.ps1	Adds cmdlet to list labels on a page via v2 endpoint.
src/functions/public/Labels/Add-ConfluenceLabel.ps1	Adds cmdlet to add labels via v1 endpoint with explicit JSON array payload.
src/functions/public/Get-PSModuleTest.ps1	Removes scaffold public function.
src/functions/public/Folders/Remove-ConfluenceFolder.ps1	Adds cmdlet to delete/trash a folder.
src/functions/public/Folders/New-ConfluenceFolder.ps1	Adds cmdlet to create a folder (optional parent).
src/functions/public/Folders/Get-ConfluenceFolder.ps1	Adds cmdlet to fetch a folder by id.
src/functions/public/ContentProperties/Set-ConfluenceContentProperty.ps1	Adds cmdlet to create/update a content property with version increment.
src/functions/public/ContentProperties/Remove-ConfluenceContentProperty.ps1	Adds cmdlet to delete a content property by id.
src/functions/public/ContentProperties/Get-ConfluenceContentProperty.ps1	Adds cmdlet to list/get content properties by key.
src/functions/public/Config/Set-ConfluenceConfig.ps1	Adds cmdlet to set and persist module config in the Context vault.
src/functions/public/Config/Get-ConfluenceConfig.ps1	Adds cmdlet to read module config (whole or key).
src/functions/public/Comments/Remove-ConfluenceComment.ps1	Adds cmdlet to delete footer comments by id.
src/functions/public/Comments/Get-ConfluenceComment.ps1	Adds cmdlet to list footer comments on a page.
src/functions/public/Comments/Add-ConfluenceComment.ps1	Adds cmdlet to create a footer comment.
src/functions/public/BlogPosts/Get-ConfluenceBlogPost.ps1	Adds cmdlet to list/get blog posts.
src/functions/public/Auth/Get-ConfluenceContext.ps1	Adds cmdlet to retrieve stored Confluence contexts/default context.
src/functions/public/Auth/Get-ConfluenceAccessibleResource.ps1	Adds cmdlet to call accessible-resources with bearer token.
src/functions/public/Auth/Disconnect-Confluence.ps1	Adds cmdlet to remove a stored context and clear default if needed.
src/functions/public/Auth/Connect-Confluence.ps1	Adds cmdlet to resolve cloudId (optional), validate token, store context, set default.
src/functions/public/Attachments/Remove-ConfluenceAttachment.ps1	Adds cmdlet to delete attachments by id.
src/functions/public/Attachments/Get-ConfluenceAttachment.ps1	Adds cmdlet to list attachments for a page or get by id.
src/functions/public/Attachments/Add-ConfluenceAttachment.ps1	Adds cmdlet to upload an attachment via multipart form.
src/functions/public/API/Invoke-ConfluenceRestMethod.ps1	Adds core REST invoker (auth/header, pagination, error shaping, debug redaction).
src/functions/private/Config/Initialize-ConfluenceConfig.ps1	Adds private config loader/backfill/persist logic.
src/functions/private/Config/ConvertTo-ConfluenceHashtable.ps1	Adds helper to convert stored objects into mutable hashtables.
src/functions/private/Auth/Resolve-ConfluenceToken.ps1	Adds helper to extract plaintext token from SecureString/string.
src/functions/private/Auth/Resolve-ConfluenceContext.ps1	Adds helper to resolve context object/name/default into a usable context.
src/finally.ps1	Removes placeholder “last loader” output.
SCOPES.md	Adds scope inventory and mapping from cmdlets to required Confluence scopes.
README.md	Updates README from placeholder to install/usage/docs for the implemented module.
examples/Pages.ps1	Adds example script for CRUD-ish page workflows plus labels/comments.
examples/General.ps1	Removes unrelated scaffold example content.
examples/Connecting.ps1	Adds example script for connecting and managing contexts/config.
.github/workflows/Process-PSModule.yml	Updates workflow to pin a feature SHA and pass minimal secrets/test data.

---

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

[Copilot]

Pull request overview

Copilot reviewed 55 out of 55 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 55 out of 55 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 59 out of 59 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

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

[Copilot]

Pull request overview

Copilot reviewed 59 out of 59 changed files in this pull request and generated 2 comments.