---
title: "GetTopology returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind."
method: GET
path: "/rest-api/v1/insight/topology"
tags: ["insight"]
---

# GetTopology returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind.

`GET /rest-api/v1/insight/topology`

This endpoint returns a topology map for a Kubernetes resource by name, namespace, cluster, apiVersion and kind.

## Query parameters

- `cluster` string
- `apiVersion` string
- `kind` string
- `namespace` string
- `name` string
- `forceNew` boolean

## Response `200`

map from string to resource.ResourceTopology

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `405` — Method Not Allowed
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2024-01-29** `494c90027ebc` — 1 info
  - added the new optional `query` request parameter `forceNew`
- **2023-12-29** `fa4b9c305a29` — 1 info
  - endpoint added
- **2023-12-11** `2a20fa0acab4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/kusionstack/apis/karpor/changes/rest-api/v1/insight/topology/get.md)

---

[API](https://skmtc.dev/kusionstack/apis/karpor.md) · [All operations](https://skmtc.dev/kusionstack/apis/karpor/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kusionstack/karpor/revisions/d741ac56c269/schema)