List Spaces


acs2md space list [flags]

Lists all Confluence spaces that your account has access to. Use this to discover space keys before running a conversion.

For most new operators, this is the first real discovery command after doctor.

Examples


# List all spaces in a table (default)
acs2md space list
 
# Filter to global spaces only
acs2md space list --type global
 
# JSON output
acs2md space list --format json
 
# Save to file
acs2md space list --format json --output spaces.json
 
# Limit results
acs2md space list --limit 20
 
# Paginate using a cursor
acs2md space list --cursor NEXT_CURSOR_TOKEN
 
# Show author names instead of account IDs
acs2md space list --resolve-users

Flags

Flag	Short	Default	Description
`--format`	`-f`	`table`	Output format: `table`, `json`, `yaml`
`--output`	`-o`	(stdout)	Output file path
`--type`	`-t`	(all)	Filter by space type: `global`, `personal`
`--status`	`-s`	(all)	Filter by space status: `current`, `archived`
`--limit`	`-l`	`25`	Number of results per page
`--cursor`	`-c`	(none)	Pagination cursor for the next page of results
`--resolve-users`		`false`	Resolve account IDs to display names (makes additional API calls)

When --resolve-users is active, a progress bar appears on stderr while resolving user names. The table output includes both an “Author” column (display name) and an “Author ID” column.

Sample output (table)


KEY        TITLE                        TYPE       STATUS
──────────────────────────────────────────────────────────
DOCS       Product Documentation        global     current
ENG        Engineering                  global     current
KB         Knowledge Base               global     current
~alice     Alice's personal space       personal   current
ARCH       Archive                      global     current

Sample output (JSON)


[
  {
    "id": "65539",
    "key": "DOCS",
    "name": "Product Documentation",
    "type": "global",
    "status": "current"
  },
  ...
]

Pagination

When there are more results than --limit, the table output indicates that more pages are available. Use --cursor with the cursor token from the previous response to retrieve the next page:


# First page
acs2md space list --limit 10 --format json --output page1.json
 
# Next page (use the cursor value from the previous response)
acs2md space list --limit 10 --cursor eyJsaW1pdCI6... --format json

Use JSON output when you need to hand the results to automation, reporting, or a stakeholder review process.