Provide REST API endpoints to manage Space Shortcuts (add/remove/list)

XMLWordPrintable

    • 1

      Problem Statement

      Confluence Cloud currently has no REST API (v1 or v2) for managing space shortcuts — the quick-access links that appear in a space's sidebar. There's simply no way to add, update, list, or remove them programmatically. Everything has to be done manually through the UI, which makes it impossible to fully automate space provisioning or enforce consistent navigation across an organization.

      Use Case

      Primary — Space Analytics workaround can't scale

      Under the new RBAC model, Space Analytics is invisible to space owners unless they have "Manage everything in space." Even a custom role with the correct Analytics permissions doesn't surface the Analytics option in the space admin menu.

      Atlassian Support's recommended workaround is to add a direct bookmark (/wiki/spaces/<SPACE_KEY>/analytics) as a space shortcut. The problem? Without an API, this shortcut has to be added manually to every single space.

      The customer has built an intranet portal where teams request Confluence spaces, and upon approval, spaces are fully provisioned via the API — permissions, pages, labels, everything. Shortcuts are the one piece that can't be automated, meaning every new space still requires manual follow-up just to add a navigation link.

      Secondary — Bulk migration and standardized navigation

      The customer is also migrating to Confluence Cloud and will be creating spaces in bulk. Shortcuts need to be part of that automated migration workflow — going back to configure them by hand across hundreds or thousands of spaces isn't realistic.

      Beyond migration, different types of spaces (product, team, strategy) should come pre-loaded with relevant links — a Jira board, Slack channel, Google Group, or address book. Without an API, there's no way to roll out a consistent set of shortcuts across spaces of the same type.

      Expected API Capabilities

      • List shortcuts for a given space
      • Add a shortcut to a space (with label and URL)
      • Remove a shortcut from a space
      • Update an existing shortcut

      Business Impact

      • Blocks fully automated space provisioning workflows
      • Requires manual intervention for each new space, which does not scale across thousands of spaces
      • Workaround for a separate bug (Space Analytics not visible under custom RBAC roles) cannot be deployed at scale without this API

              Assignee:
              Unassigned
              Reporter:
              Tanya -
              Votes:
              1 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: