Confluence
Use flowbot confluence for capability confluence.
CLI root is confluence — do not invent flowbot confluence unless cli.md lists it as an alias.
Prefer the workflows below; load references/cli.md only when you need a flag or subcommand not covered here.
JSON fields: Page and space ids are strings; page content uses Confluence storage XHTML.
Setup
- Ensure CLI auth:
flowbot login - Set server via
FLOWBOT_SERVER_URLor--server-url; optional--profile,--debug/-d - Prefer
-o jsonwhen parsing results programmatically - Destructive commands often need
-y/--yesin non-interactive sessions — check cli.md - Token scopes:
service:confluence:read/service:confluence:write
Workflows
Create a wiki page
When a user wants to add a Confluence page:
flowbot confluence space listflowbot confluence page create --space-key <KEY> -t "<title>" -c "<p>content</p>"
Find and read a page
When a user wants to open Confluence content:
flowbot confluence page search --cql "text ~ '<keywords>'"flowbot confluence page content <page_id>
Troubleshooting
| Error | Fix |
|---|---|
| not logged in | flowbot login |
| server URL is required | set FLOWBOT_SERVER_URL or pass --server-url |
| permission denied / 403 | token missing service scopes (service:confluence:read / service:confluence:write) |
| hung waiting for confirm or exit 7 | pass --yes / -y. --no-input without --yes exits 7 and does not read stdin |
| empty results | provider not configured, wrong id/name, or empty dataset |
| unknown command | use flowbot confluence, not the capability id as the CLI verb |