Portal URLs

​

How addresses are built

• The organisation comes from your session. Most pages live under /organisation/... and show the organisation you have selected in the top-left switcher. Only the organisation admin pages (members, service tokens and organisation settings) put the organisation id in the path.
• ?org= opens a link in the right organisation. Links from Ankra (notifications, AI answers, MCP results) add ?org=<organisation-id>. If that is not your current organisation, the portal offers to switch to it instead of showing “Resource not found”.
• Clusters are addressed by id, not by name. Every cluster page starts with /organisation/clusters/cluster/imported/<cluster-id>/. The imported segment is used for every cluster, including ones Ankra built. ankra cluster info -o json, ankra cluster list -o json and the list_clusters MCP tool all return the id.
• Stacks and add-ons are addressed by name within their cluster. Kubernetes workloads are addressed by namespace and name.

​

Organisation pages

​

Cluster pages

​

Applications and pipelines

​

AI

​

Links from AI and MCP clients

• list_clusters and get_cluster_details return each cluster’s portal_url (its overview page).
• get_portal_url returns the link for any page on this list. It takes a page (for example cluster_overview, addon, pod, application, pipeline_run, ticket or cve) and the ids that page needs, and it reads and changes nothing, so an mcp:read token can call it.

{
  "name": "get_portal_url",
  "arguments": { "page": "addon", "cluster_id": "5d1f3a52-7e0b-4f3c-9b8f-0f6d3c2a1b4e", "addon_name": "cert-manager" }
}

{
  "page": "addon",
  "url": "https://platform.ankra.app/organisation/clusters/cluster/imported/5d1f3a52-7e0b-4f3c-9b8f-0f6d3c2a1b4e/add-ons/add-on/cert-manager?org=<organisation-id>",
  "description": "One add-on: status, values, the resources it created and its history."
}

​

Links from the CLI and notifications

• Cluster creation and ankra cluster apply print View it in the UI: with the cluster’s overview URL.
• ankra cluster debug prints a link to the debug pod’s terminal.
• Slack, Microsoft Teams, email and webhook notifications link to the alert firing, ticket, pipeline run or cluster page they are about, and carry the organisation the page belongs to.

​

Related