confluence_get_spaces
Retrieve Confluence spaces with filtering by name, key, ID, type, status, labels, or sort order. Supports pagination and optional raw response.
Instructions
Get all spaces. Returns spaces filtered by various parameters. Results are paginated - use the returned cursor to fetch more pages if you don't find what you need. To find a space by name, use nameContains (case-insensitive substring match), which auto-pages server-side and returns matching results without forcing the caller to walk every page. For an exact-name lookup, CQL search (type = "space" AND title = "...") is also fast. Output is trimmed by default (drops _links, _expandable, body content, etc.); pass full=true to receive the raw Confluence response.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Filter by space IDs | |
| full | No | If true, bypass response trimming and return the raw Confluence API response. | |
| keys | No | Filter by space keys | |
| sort | No | Sort order (prefix with - for descending) | |
| type | No | Filter by space type | |
| limit | No | Maximum number of results (default 25, max 250) | |
| cursor | No | Cursor for pagination | |
| labels | No | Filter by labels | |
| status | No | Filter by space status | |
| nameContains | No | Case-insensitive substring filter on space name. Applied client-side; the server does not natively support name search. The handler pages through up to `nameSearchMaxScanned` spaces (default 2000) until enough matches are found. Combine with `type` to narrow the scan. | |
| descriptionFormat | No | Format for space description | |
| nameSearchMaxScanned | No | Maximum number of spaces to scan when filtering by `nameContains`. Default 2000. |