Confluence

Confluence is the dominant enterprise wiki — used by most organizations that use Jira for documentation, runbooks, ADRs, meeting notes, and knowledge management. For agents: create pages from templates (post-incident reports, release notes, ADRs), update existing pages with new content, search the knowledge base via CQL, extract page content for RAG pipelines, and manage page hierarchies. REST API v2 (Cloud) is cleaner than v1. API token auth is simple to set up. Free tier (10 users, shared with Jira). Confidence is docs-derived.

REST API v2 at api.atlassian.com/wiki/api/v2 (Cloud). GET /pages lists pages (filter by space key, title). GET /pages/{id} retrieves page content (body in storage format or view format). POST /pages creates a page ({spaceId, parentId, title, body: {value: "...", representation: "storage"}}). PUT /pages/{id} updates a page (requires version number — increment by 1). POST /pages/{id}/attachments uploads an attachment. GET /spaces lists spaces. GET /spaces/{id}/pages lists pages in a space. POST /blogposts creates a blog post. CQL search: GET /v2/search/content?cql=type=page+AND+space=MYSPACE+AND+title~"Runbook". Confluence storage format: XHTML-like markup for page content.

API token auth: Basic auth (email:api_token). Same Atlassian token as Jira. Cloud ID: not required for Confluence (uses wiki subdomain: {subdomain}.atlassian.net/wiki/api/v2). HTTPS enforced. OAuth2 for multi-user apps. Read/write scopes: read:confluence-content.all, write:confluence-content. Page version management: optimistic locking via version.number in PUT request (409 if version mismatch).

Standard HTTP status codes with JSON error bodies. 409 for version conflict on page update (must fetch current version first). 400 for invalid storage format content. Page content: storage format requires valid XHTML-like structure — render errors if malformed. CQL search: familiar SQL-like syntax, but errors return generic 400. Space key vs space ID: v2 API uses numeric IDs; space keys from v1 endpoints. Confluence Cloud uptime at status.atlassian.com. Content size limit: ~2MB per page body (storage format).

developer.atlassian.com/cloud/confluence/rest/v2 covers REST API reference for pages, spaces, blog posts, attachments, and search. Getting started: same Atlassian account + API token as Jira, first page creation in under 10 minutes. atlassian-python-api supports Confluence operations. Confluence storage format reference for content structure. Community via Atlassian Community developer forum. Documentation is comprehensive but the storage format learning curve is real.