confluencelisted

# Confluence Skill Interact with Confluence Cloud to search pages, read documentation, create or update content, and browse spaces. ## Auth Approach Do NOT check authentication upfront. Just run the command. If it fails with an auth error, see the **Self-Healing** section for diagnostics. **NEVER print, echo, or log the values of `ATLASSIAN_API_TOKEN`, `ATLASSIAN_EMAIL`, or any credentials.** Only check whether they are set (e.g., `test -n`), never display their contents. ## Tool Preference **Prefer raw curl for all operations.** `acli` has limited Confluence coverage (page view by ID, space list/view only) — fall back to it only for those read operations if curl fails. All write operations require curl. ### Curl base URLs Two API versions are in use. Use the correct one for each operation: | API | Base URL | Used for | |-----|----------|----------| | **v1** | `https://$ATLASSIAN_DOMAIN.atlassian.net/wiki/rest/api/...` | CQL search only | | **v2** | `https://$ATLASSIAN_DOMAIN.atlassian.net/wiki/api/v2/...` | Everything else | ### Curl auth pattern ```bash curl -s -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \ -H "Accept: application/json" \ "https://$ATLASSIAN_DOMAIN.atlassian.net/wiki/api/v2/..." ``` ## Operations — Read ### Search pages (CQL) **curl** (v1 API) — acli does not support CQL search. ```bash curl -s -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \ -H "Accept: application/json" \ "https://$ATLASSIAN_DOMAIN.atlassian.net/wiki/rest/api/search?cql=t