list-spaces

list-spaces

List Confluence spaces with optional filtering capabilities.

PURPOSE: Discovers available spaces in your Confluence instance with their keys, names, types, and URLs.

WHEN TO USE:

When you need to discover what spaces exist in your Confluence instance
When you want to find spaces by type (global, personal, archived)
When you need to browse available spaces before accessing specific pages
When you need space keys for use with other Confluence tools

WHEN NOT TO USE:

When you already know the specific space key/ID (use get-space instead)
When you need detailed information about a specific space (use get-space instead)
When you need to find content across multiple spaces (use search instead)
When you need to list pages within a specific space (use list-pages instead)

RETURNS: Formatted list of spaces with IDs, keys, names, types, and URLs, plus pagination info.

EXAMPLES:

List all spaces: {}
Filter by type: {type: "global"}
With pagination: {limit: 10, cursor: "next-page-token"}

ERRORS:

Authentication failures: Check your Confluence credentials
No spaces found: Verify your permissions in Confluence
Rate limiting: Use pagination and reduce query frequency

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Use this to navigate through large result sets. The cursor value can be obtained from the pagination information in a previous response.
`limit`	No	Maximum number of spaces to return (1-250). Use this to control the response size. Useful for pagination or when you only need a few results.
`status`	No	Filter spaces by status. Options: "current" (active spaces) or "archived" (inactive spaces). Defaults to "current" if not specified.
`type`	No	Filter spaces by type. Options: "global" (company-wide spaces), "personal" (user-specific spaces), "collaboration" (team spaces), or "knowledge_base" (documentation spaces). Defaults to "global" if not specified.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "Pagination cursor for retrieving the next set of results. Use this to navigate through large result sets. The cursor value can be obtained from the pagination information in a previous response.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of spaces to return (1-250). Use this to control the response size. Useful for pagination or when you only need a few results.",
      "maximum": 250,
      "minimum": 1,
      "type": "number"
    },
    "status": {
      "description": "Filter spaces by status. Options: \"current\" (active spaces) or \"archived\" (inactive spaces). Defaults to \"current\" if not specified.",
      "enum": [
        "current",
        "archived"
      ],
      "type": "string"
    },
    "type": {
      "description": "Filter spaces by type. Options: \"global\" (company-wide spaces), \"personal\" (user-specific spaces), \"collaboration\" (team spaces), or \"knowledge_base\" (documentation spaces). Defaults to \"global\" if not specified.",
      "enum": [
        "global",
        "personal",
        "collaboration",
        "knowledge_base"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Input Schema

Input Schema (JSON Schema)

Other Tools