---
title: "List knowledge graph edges"
method: GET
path: "/knowledgeGraph/edges"
tags: ["KnowledgeGraph"]
---

# List knowledge graph edges

`GET /knowledgeGraph/edges`

Lists edges in a knowledge graph with optional filters. Note: application_id is used for auth scope but does not filter result rows (knowledge_graph_edge has no application_id column).

## Query parameters

- `workspace_id` string, required
- `application_id` string
- `source_node_id` string
- `destination_node_id` string
- `label` 'CONTAINS' | 'HAS_KNOWLEDGE' | 'DEPENDS_ON' | 'RELATED_TO' | 'COVERS' — Label for a knowledge graph edge indicating its relationship type
- `limit` integer
- `cursor` string

## Response `200`

The list of edges

- KnowledgeGraphEdgeListResult — Paginated list result for knowledge graph edges
  - `edges` KnowledgeGraphEdge[]
    - `edge_id` string — Unique identifier for the edge (server-generated, suffix -kge)
    - `workspace_id` string — The workspace this edge belongs to
    - `source_node_id` string — The source node ID
    - `destination_node_id` string — The destination node ID
    - `label` 'CONTAINS' | 'HAS_KNOWLEDGE' | 'DEPENDS_ON' | 'RELATED_TO' | 'COVERS' — Label for a knowledge graph edge indicating its relationship type
    - `ordinal` integer — Ordering hint for sibling edges
    - `weight` number, double — Edge weight (0.0-1.0)
    - `description` string — Human-readable description of this relationship
    - `properties` object — Additional structured properties for this edge
    - `version` integer — Monotonic edit counter (server-managed, readOnly)
    - `u_version_` string — ETag for optimistic locking (server-managed, readOnly)
    - `last_updated_by` string — Principal who last updated this edge (server-managed, readOnly)
    - `created_by` string — Principal who created this edge (server-managed, readOnly)
    - `agent_type` string — Agent type that wrote this edge
    - `agent_version` string — Agent version that wrote this edge
    - `created_at` string, date-time — Creation timestamp
    - `updated_at` string, date-time — Last update timestamp
  - `cursor` string — Cursor for fetching the next page of results (absent when no more pages)

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)