Introduction
# Confluence Cloud REST API v2
Use this skill to call **Confluence Cloud REST API v2** endpoints directly. Supports **all v2 groups** (pages, spaces, folders, whiteboards, databases, embeds, comments, labels, properties, tasks, etc.).
## Quick Start
1) Configure credentials (one of): - **Basic**: email + API token - **OAuth**: access token
2) Call endpoints using scripts in `scripts/`.
## Config
Set these env vars (preferred) or store in a local config file:
``` CONFLUENCE_BASE_URL=https://pangin.atlassian.net/wiki CONFLUENCE_AUTH_METHOD=basic # basic | oauth [email protected] CONFLUENCE_API_TOKEN=YOUR_TOKEN # or for OAuth # CONFLUENCE_OAUTH_TOKEN=YOUR_OAUTH_ACCESS_TOKEN
# Optional admin key header (Premium/Enterprise only) # CONFLUENCE_ADMIN_KEY=true ```
**Base URL** is always `https://<site>.atlassian.net/wiki`.
## Core Helpers
- `scripts/client.js` — HTTP client wrapper, auth header, pagination - `scripts/*` — endpoint groups (pages, spaces, folders, etc.)
## Example
```bash # list everything node scripts/spaces.js list --all node scripts/pages.js list --all node scripts/labels.js list --all
# get single items node scripts/pages.js get 89522178 node scripts/folders.js direct-children 87457793
# ad-hoc call node scripts/call.js GET /folders/87457793/direct-children ```
## Migration from confluence-cli
If `~/.confluence-cli/config.json` exists, map: - `domain` → `CONFLUENCE_BASE_URL` (`https://{domain}/wiki`) - `email` → `CONFLUENCE_EMAIL` - `token` → `CONFLUENCE_API_TOKEN`
## References
- OpenAPI spec: `refs/openapi-v2.v3.json` - Endpoints list: `refs/endpoints.md` - Scopes: `refs/scopes.md` - Tests: `refs/tests.md` - Usage tips: `refs/usage.md`