How do I install the Confluence Atlassian skill?

Run npx skillmds@latest add luokai0/confluence-atlassian in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Confluence Atlassian skill do?

Full-featured Confluence Cloud REST API v2 skill. Manage pages, spaces, blogposts, attachments, comments, labels, and more via direct Atlassian API calls. Use when managing Confluence content, creating/updating pages, working with spaces, or interacting with Confluence via API. Requires Atlassian email and API token for authentication. It is listed under DevOps & Infra on SkillMD.

Is Confluence Atlassian safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: WARNING. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Confluence Atlassian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Confluence Atlassian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Confluence Atlassian?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Confluence Atlassian by luokai0 — Agent Skill

Name: Confluence Atlassian
Rating: 4.666666666666667 (3 reviews)
Author: luokai0

Confluence REST API v2 Skill

Interact with Atlassian Confluence Cloud using the REST API v2. This skill enables reading, creating, updating, and deleting Confluence content including pages, blog posts, attachments, comments, spaces, labels, and more.

Authentication

Basic Auth (Email + API Token)

Required Environment Variables:

CONFLUENCE_EMAIL=your_email@example.com
CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_DOMAIN=your_domain  # e.g. "yourcompany" for yourcompany.atlassian.net

Base URL

https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2

Generate API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens
Click "Create API token"
Label it (e.g., "nanobot")
Copy the token

curl Authentication

--user "$CONFLUENCE_EMAIL:$CONFLUENCE_API_TOKEN"

curl Authentication Header:

-H "Authorization: Basic $(echo -n '$CONFLUENCE_EMAIL:$CONFLUENCE_API_TOKEN' | base64)"

Generate Base64 Auth String

# Linux/Mac
echo -n "$CONFLUENCE_EMAIL:$CONFLUENCE_API_TOKEN" | base64

# Windows PowerShell
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("$CONFLUENCE_EMAIL:$CONFLUENCE_API_TOKEN"))

Rate Limiting

If you encounter HTTP 429 (Too Many Requests), wait 5-10 seconds and retry automatically
Maximum 3 retries with exponential backoff

Common Headers

-H "Accept: application/json"
-H "Content-Type: application/json"
-H "Authorization: Basic <base64_encoded_auth>"

API Endpoints Reference

Total: 100+ API Endpoints across 29 API Groups

1. Admin Key (3 endpoints)

Method	Endpoint	Description
GET	`/admin-key`	Get Admin Key status
POST	`/admin-key`	Enable Admin Key
DELETE	`/admin-key`	Disable Admin Key

Get Admin Key:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/admin-key" \
  -H "Authorization: Basic <base64_auth>"

Enable Admin Key (10 min default):

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/admin-key" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{"durationInMinutes": 10}'

2. Attachment (8 endpoints)

Method	Endpoint	Description
GET	`/attachments`	Get all attachments
GET	`/attachments/{id}`	Get attachment by ID
DELETE	`/attachments/{id}`	Delete attachment
GET	`/attachments/{id}/labels`	Get labels for attachment
GET	`/attachments/{id}/operations`	Get permitted operations
GET	`/attachments/{id}/versions`	Get attachment versions
GET	`/attachments/{id}/versions/{version-number}`	Get version details
GET	`/attachments/{id}/footer-comments`	Get attachment comments

Get All Attachments:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/attachments?limit=25" \
  -H "Authorization: Basic <base64_auth>"

Get Attachment by ID:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/attachments/att123456" \
  -H "Authorization: Basic <base64_auth>"

Delete Attachment (move to trash):

curl -X DELETE "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/attachments/att123456" \
  -H "Authorization: Basic <base64_auth>"

Purge (permanently delete) trashed attachment:

curl -X DELETE "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/attachments/att123456?purge=true" \
  -H "Authorization: Basic <base64_auth>"

3. Blog Post (15 endpoints)

Method	Endpoint	Description
GET	`/blogposts`	Get all blog posts
POST	`/blogposts`	Create blog post
GET	`/blogposts/{id}`	Get blog post by ID
PUT	`/blogposts/{id}`	Update blog post
DELETE	`/blogposts/{id}`	Delete blog post
GET	`/blogposts/{id}/attachments`	Get attachments
GET	`/blogposts/{id}/custom-content`	Get custom content
GET	`/blogposts/{id}/labels`	Get labels
GET	`/blogposts/{id}/likes/count`	Get like count
GET	`/blogposts/{id}/likes/users`	Get users who liked
GET	`/blogposts/{id}/operations`	Get operations
GET	`/blogposts/{id}/versions`	Get versions
GET	`/blogposts/{id}/versions/{version-number}`	Get version details
GET	`/blogposts/{id}/footer-comments`	Get footer comments
GET	`/blogposts/{id}/inline-comments`	Get inline comments

Get All Blog Posts:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/blogposts?limit=25&space-id=123" \
  -H "Authorization: Basic <base64_auth>"

Create Blog Post:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/blogposts" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "SPACE_KEY",
    "title": "My Blog Post",
    "body": {
      "representation": "storage",
      "value": "<p>Blog post content here</p>"
    }
  }'

Get Blog Post with Body:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/blogposts/123?body-format=storage" \
  -H "Authorization: Basic <base64_auth>"

4. Comment (12 endpoints)

Method	Endpoint	Description
GET	`/footer-comments`	Get all footer comments
POST	`/footer-comments`	Create footer comment
GET	`/footer-comments/{comment-id}`	Get footer comment
PUT	`/footer-comments/{comment-id}`	Update footer comment
DELETE	`/footer-comments/{comment-id}`	Delete footer comment
GET	`/footer-comments/{id}/children`	Get child comments
GET	`/inline-comments`	Get all inline comments
POST	`/inline-comments`	Create inline comment
GET	`/inline-comments/{comment-id}`	Get inline comment
PUT	`/inline-comments/{comment-id}`	Update inline comment
DELETE	`/inline-comments/{comment-id}`	Delete inline comment
GET	`/inline-comments/{id}/children`	Get child inline comments

Create Footer Comment on Page:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/footer-comments" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "pageId": "123456",
    "body": {
      "representation": "storage",
      "value": "<p>Comment content</p>"
    }
  }'

Create Inline Comment:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/inline-comments" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "pageId": "123456",
    "body": {
      "representation": "storage",
      "value": "<p>Inline comment</p>"
    },
    "inlineCommentProperties": {
      "textSelection": "selected text",
      "textSelectionMatchCount": 1,
      "textSelectionMatchIndex": 0
    }
  }'

Resolve Inline Comment:

curl -X PUT "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/inline-comments/123" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": {"number": 2},
    "resolved": true
  }'

5. Content Properties (40 endpoints)

For: Attachments, Blog Posts, Pages, Custom Content, Whiteboards, Databases, Folders, Comments, Smart Links

Method	Endpoint Pattern	Description
GET	`/{type}/{id}/properties`	Get all properties
POST	`/{type}/{id}/properties`	Create property
GET	`/{type}/{id}/properties/{property-id}`	Get property
PUT	`/{type}/{id}/properties/{property-id}`	Update property
DELETE	`/{type}/{id}/properties/{property-id}`	Delete property

Get Page Properties:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/properties" \
  -H "Authorization: Basic <base64_auth>"

Create Page Property:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/properties" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "custom-key",
    "value": {"nested": "value"}
  }'

Update Page Property:

curl -X PUT "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/properties/789" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "custom-key",
    "value": {"updated": "value"},
    "version": {"number": 2}
  }'

6. Label (14 endpoints)

Method	Endpoint	Description
GET	`/labels`	Get all labels
GET	`/labels/{id}/attachments`	Get attachments with label
GET	`/labels/{id}/blogposts`	Get blog posts with label
GET	`/labels/{id}/pages`	Get pages with label
GET	`/attachments/{id}/labels`	Get attachment labels
GET	`/blogposts/{id}/labels`	Get blog post labels
GET	`/custom-content/{id}/labels`	Get custom content labels
GET	`/pages/{id}/labels`	Get page labels
GET	`/spaces/{id}/labels`	Get space labels
GET	`/spaces/{id}/content/labels`	Get space content labels

Get Page Labels:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/labels" \
  -H "Authorization: Basic <base64_auth>"

7. Page (14 endpoints)

Method	Endpoint	Description
GET	`/pages`	Get all pages
POST	`/pages`	Create page
GET	`/pages/{id}`	Get page by ID
PUT	`/pages/{id}`	Update page
DELETE	`/pages/{id}`	Delete page
PUT	`/pages/{id}/title`	Update page title
GET	`/pages/{id}/attachments`	Get attachments
GET	`/pages/{id}/custom-content`	Get custom content
GET	`/pages/{id}/labels`	Get labels
GET	`/pages/{id}/operations`	Get operations
GET	`/pages/{id}/versions`	Get versions
GET	`/pages/{id}/versions/{version-number}`	Get version details
GET	`/pages/{id}/footer-comments`	Get footer comments
GET	`/pages/{id}/inline-comments`	Get inline comments

Get All Pages in Space:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages?space-id=123&limit=50" \
  -H "Authorization: Basic <base64_auth>"

Get Page with Body:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456?body-format=storage" \
  -H "Authorization: Basic <base64_auth>"

Create Page:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "SPACE_KEY",
    "title": "My New Page",
    "parentId": "123456",
    "body": {
      "representation": "storage",
      "value": "<p>Page content in storage format</p>"
    }
  }'

Update Page:

curl -X PUT "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "123456",
    "status": "current",
    "title": "Updated Page Title",
    "body": {
      "representation": "storage",
      "value": "<p>Updated content</p>"
    },
    "version": {
      "number": 5,
      "message": "Updated page content"
    }
  }'

Delete Page (move to trash):

curl -X DELETE "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456" \
  -H "Authorization: Basic <base64_auth>"

8. Space (22 endpoints)

Method	Endpoint	Description
GET	`/spaces`	Get all spaces
POST	`/spaces`	Create space
GET	`/spaces/{id}`	Get space by ID
PUT	`/spaces/{id}`	Update space
DELETE	`/spaces/{id}`	Delete space
GET	`/spaces/{id}/pages`	Get space pages
GET	`/spaces/{id}/pages/search`	Search pages in space
GET	`/spaces/{id}/blogposts`	Get space blog posts
GET	`/spaces/{id}/content`	Get space content
GET	`/spaces/{id}/content/types`	Get content types
GET	`/spaces/{id}/labels`	Get space labels
GET	`/spaces/{id}/content/labels`	Get space content labels
GET	`/spaces/{id}/operations`	Get space operations
GET	`/spaces/{id}/permissions`	Get space permissions
GET	`/spaces/{id}/properties`	Get space properties
POST	`/spaces/{id}/properties`	Create space property
GET	`/spaces/{id}/properties/{property-id}`	Get space property
PUT	`/spaces/{id}/properties/{property-id}`	Update space property
DELETE	`/spaces/{id}/properties/{property-id}`	Delete space property
GET	`/spaces/{id}/icons`	Get space icons
POST	`/spaces/{id}/icons`	Set space icon
GET	`/spaces/{id}/lookups`	Lookup space by key

Get All Spaces:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/spaces?limit=50" \
  -H "Authorization: Basic <base64_auth>"

Get Space by Key:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/spaces?keys=SPACE_KEY" \
  -H "Authorization: Basic <base64_auth>"

Create Space:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/spaces" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New Space",
    "key": "MYSpace",
    "description": {
      "plain": {
        "value": "Space description"
      }
    }
  }'

9. User (9 endpoints)

Method	Endpoint	Description
GET	`/users/me`	Get current user
GET	`/users/{id}`	Get user by ID
GET	`/users/bulk`	Get multiple users
POST	`/users/bulk`	Bulk get users by emails
GET	`/user/access/check-access-by-email`	Check user access by email
POST	`/user/access/check-access-by-email`	Check user access
GET	`/user/access/invite-by-email`	Get user invite by email
POST	`/user/access/invite-by-email`	Invite user by email
POST	`/user/access/batch-invite-by-email`	Batch invite users

Get Current User:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/users/me" \
  -H "Authorization: Basic <base64_auth>"

Get User by ID:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/users/123456" \
  -H "Authorization: Basic <base64_auth>"

Bulk Get Users:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/users/bulk?ids=123,456" \
  -H "Authorization: Basic <base64_auth>"

10. Version History (8 endpoints)

Method	Endpoint	Description
GET	`/pages/{id}/versions`	Get page versions
GET	`/pages/{id}/versions/{version-number}`	Get specific version
GET	`/blogposts/{id}/versions`	Get blog post versions
GET	`/blogposts/{id}/versions/{version-number}`	Get specific version
GET	`/attachments/{id}/versions`	Get attachment versions
GET	`/attachments/{id}/versions/{version-number}`	Get specific version
POST	`/pages/{id}/versions/restore`	Restore page version
POST	`/blogposts/{id}/versions/restore`	Restore blog post version

Get Page Versions:

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/versions?limit=10" \
  -H "Authorization: Basic <base64_auth>"

Restore Page Version:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/versions/restore" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{"newVersion": {"message": "Restoring previous version"}}'

11. Whiteboard (7 endpoints)

Method	Endpoint	Description
GET	`/whiteboards`	Get all whiteboards
POST	`/whiteboards`	Create whiteboard
GET	`/whiteboards/{id}`	Get whiteboard by ID
PUT	`/whiteboards/{id}`	Update whiteboard
DELETE	`/whiteboards/{id}`	Delete whiteboard
GET	`/whiteboards/{id}/connections`	Get whiteboard connections
GET	`/whiteboards/{id}/operations`	Get whiteboard operations

Create Whiteboard:

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/whiteboards" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "123456",
    "title": "My Whiteboard"
  }'

Pagination

The V2 API uses cursor-based pagination. Responses include a _links.next URL when more results are available.

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages?space-id=123456&limit=100" \
  -H "Authorization: Basic <base64_auth>"

Response:

{
  "results": [...],
  "_links": {
    "next": "/wiki/api/v2/pages?cursor=abc123",
    "base": "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki"
  }
}

Search

Search Pages by Title

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages?title=My%20Page&space-id=123456" \
  -H "Authorization: Basic <base64_auth>"

Get Page with All Details

curl -X GET "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456?include-labels=true&include-properties=true&include-versions=true&body-format=storage" \
  -H "Authorization: Basic <base64_auth>"

Update Page Title

curl -X PUT "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/title" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{"value": "New Page Title"}'

Redact Page Content (remove sensitive content)

curl -X POST "https://$CONFLUENCE_DOMAIN.atlassian.net/wiki/api/v2/pages/123456/redact" \
  -H "Authorization: Basic <base64_auth>" \
  -H "Content-Type: application/json" \
  -d '{
    "version": {"number": 3},
    "body": {
      "representation": "storage",
      "value": "<p>Redacted content</p>"
    }
  }'

Error Handling

Status	Meaning
400	Bad request or malformed data
401	Invalid credentials or expired token
403	Permission denied
404	Resource not found
409	Conflict (e.g., duplicate title)
429	Rate limited - wait and retry
500	Internal server error

Notes

Confluence Storage Format: Content uses XML-like storage format. Example: <p>Paragraph</p>, <h1>Heading</h1>, <ul><li>Item</li></ul>
Version Numbers: When updating pages, you must increment the version number
DELETE Returns 204: DELETE operations return 204 No Content
IDs are Strings: All IDs are passed as strings
Cursor Pagination: Use the cursor from _links.next for pagination

Confluence Atlassian

File contents

Confluence REST API v2 Skill

Authentication

Basic Auth (Email + API Token)

Base URL

Generate API Token

curl Authentication

Generate Base64 Auth String

Rate Limiting

Common Headers

API Endpoints Reference

1. Admin Key (3 endpoints)

2. Attachment (8 endpoints)

3. Blog Post (15 endpoints)

4. Comment (12 endpoints)

5. Content Properties (40 endpoints)

6. Label (14 endpoints)

7. Page (14 endpoints)

8. Space (22 endpoints)

9. User (9 endpoints)

10. Version History (8 endpoints)

11. Whiteboard (7 endpoints)

Pagination

Search

Search Pages by Title

Get Page with All Details

Update Page Title

Redact Page Content (remove sensitive content)

Error Handling

Notes

Frequently asked questions

Confluence Atlassian

File contents

Confluence REST API v2 Skill

Authentication

Basic Auth (Email + API Token)

Base URL

Generate API Token

curl Authentication

Generate Base64 Auth String

Rate Limiting

Common Headers

API Endpoints Reference

1. Admin Key (3 endpoints)

2. Attachment (8 endpoints)

3. Blog Post (15 endpoints)

4. Comment (12 endpoints)

5. Content Properties (40 endpoints)

6. Label (14 endpoints)

7. Page (14 endpoints)

8. Space (22 endpoints)

9. User (9 endpoints)

10. Version History (8 endpoints)

11. Whiteboard (7 endpoints)

Pagination

Search

Search Pages by Title

Get Page with All Details

Update Page Title

Redact Page Content (remove sensitive content)

Error Handling

Notes

Related skills

Frequently asked questions

How do I install the Confluence Atlassian skill?

What does the Confluence Atlassian skill do?

Is Confluence Atlassian safe to use?

Which AI agents work with Confluence Atlassian?

Is Confluence Atlassian free to use?

Who published Confluence Atlassian?