conf_ls_spaces
List and filter Confluence spaces by type (global, personal) and status (current, archived) with pagination support. Use this tool to discover space details like ID, key, name, and URL for integration or navigation purposes.
Instructions
Lists Confluence spaces accessible to the user, with optional filtering by type
(global, personal), or status
(current, archived).
- Use this to discover spaces and find their keys needed for other tools.
- Supports pagination via
limit
andcursor
parameters. Pagination information, including next cursor value, is included directly in the returned text content. - Note: Filtering by
type
alone does not filter by status; thestatus
parameter defaults to returning spaces with all statuses (current and archived) unless explicitly set tocurrent
orarchived
. - Returns a formatted list of spaces including ID, key, name, type, status, and URL.
- Default sort is by name descending.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
cursor | No | Pagination cursor for retrieving the next set of results. Obtain this opaque string from the metadata.pagination.nextCursor of a previous response when more results are available. Confluence uses cursor-based pagination rather than offset-based pagination. | |
limit | No | Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted. The Confluence API caps results at 100 items per request. | |
status | No | Optional: Filter spaces by status. Options: "current" (active spaces) or "archived" (archived spaces). If omitted, returns spaces with all statuses. | |
type | No | Optional: Filter spaces by type. Options: "global" (team spaces), "personal" (user spaces), or "archived" (archived spaces). If omitted, returns spaces of all types. |