---
title: "Create KG node"
method: POST
path: "/api/v0/knowledge-bases/{kb_id}/graph/nodes"
tags: ["Knowledge Base Graph"]
---

# Create KG node

`POST /api/v0/knowledge-bases/{kb_id}/graph/nodes`

## 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/nodes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/knowledge-bases/:kb_id/graph/nodes/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `kb_id` string, uuid, required

## Request body

- NodeCreateRequest
  - `type_id` string, required
  - `name` string, required
  - `attributes` object
  - `selector` object, nullable
  - `confidence` number, nullable

## Response `200`

Successful Response

- NodeResponse: A :class:`KGNode`: a representation occurrence or a domain entity, told apart by ``tier``. Only a ``representation`` node carries a ``selector`` (its editable page-region geometry).
  - `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

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 1 info
  - added the optional property `reads_fields` 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/nodes/post.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)