confluence-expert
Installation
SKILL.md
Confluence Expert Skill
Platform Overview
| Interface | Base URL | Best for |
|---|---|---|
| REST API v2 | https://{domain}.atlassian.net/wiki/api/v2/ |
Preferred for Cloud — cleaner design, actively developed |
| REST API v1 | https://{domain}.atlassian.net/wiki/rest/api/ |
Legacy Cloud (being deprecated) + Data Center; still required for search, some permissions |
| Data Center v1 | https://{host}/wiki/rest/api/ |
On-prem/DC deployments — v1 only |
| CQL Search | GET /rest/api/search?cql=... |
Full-text + metadata search (v1; confirmed NOT deprecated) |
| Webhooks | POST /rest/webhooks/1.0/webhook |
Event-driven integration |
v1 vs v2 quick rule:
- Cloud: Use v2 for all new integrations. Most v1 Cloud endpoints were deprecated March 31, 2025.
- Exceptions still requiring v1:
search,content/search, space-level labels, some legacy operations
- Exceptions still requiring v1:
- Data Center: v1 only — v2 does not exist on Data Center