---
title: "Get the graph projection for a knowledge base"
method: GET
path: "/api/v0/knowledge-bases/{kb_id}/graph"
tags: ["Knowledge Base Graph"]
---

# Get the graph projection for a knowledge base

`GET /api/v0/knowledge-bases/{kb_id}/graph`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/knowledge-bases/{kb_id}/graph`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/knowledge-bases/:kb_id/graph/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `kb_id` string, uuid, required

## Response `200`

Successful Response

- KnowledgeGraphGraphResponse
  - `nodes` NodeResponse[], required
    - `id` string, uuid, required
    - `knowledge_base_id` string, uuid, required
    - `tier` 'representation' | 'domain', required
    - `type_id` string, required
    - `name` string, required
    - `attributes` object, required
    - `derived` object
    - `selector` NodeSelector
    - `reads_fields` boolean: Whether this occurrence records attribute values a collection reading read from its source (as opposed to values recorded as attribute claims).
    - `confidence` number, nullable
    - `source` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `edges` EdgeResponse[], required
    - `id` string, uuid, required
    - `knowledge_base_id` string, uuid, required
    - `edge_type_id` string, required
    - `source_public_id` string, uuid, required
    - `target_public_id` string, uuid, required
    - `attributes` object, required
    - `confidence` number, nullable
    - `source` string, required
    - `evidence` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `documents` KnowledgeGraphDocumentSummary[], required
    - `public_id` string, uuid, required
    - `name` string, required
    - `num_pages` integer, nullable, required
    - `file_type` string, nullable
  - `features` GraphPackageFeatures[], required
    - `slug` string, required
    - `version` string, required
    - `story_type_ids` string[], required: Entity types a client opens as the story they belong to rather than as themselves.
    - `interview_type_ids` string[], required: Entity types a client may start an interview about.
    - `drawing` DrawingFeatures: How a client walks this package's items on their drawings.
      - `relationships` DrawingRelationshipFeature[], required: Relationships listed for a focused item, in display order.
        - `type_id` string, required
        - `display_name` string, required: The relationship's name in the reader's language.
      - `pass_through_type_ids` string[], required: Types of the drawn run between two items: reached over a listed relationship, the walk continues from one over the same relationship to the item on its far side.
      - `element_ids_attribute` string, nullable, required: Attribute in which a domain entity lists the drawing element ids it covers.
      - `kind_attribute_names` string[], required: Attributes, in order of preference, whose first non-empty value names what kind of item an entity is; its type's name when none holds one.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 2 info
  - added the optional property `features/items/drawing` to the response with the `200` status
  - added the optional property `nodes/items/reads_fields` to the response with the `200` status
- **2026-10-22** `fd2664afd5a3`: 1 info
  - added the optional property `documents/items/file_type` to the response with the `200` status
- **2026-10-13** `7f81908bcdfe`: 1 info
  - added the required property `features` to the response with the `200` status
- **2026-09-25** `fcd15f6d35b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/knowledge-bases/:kb_id/graph/get.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)