---
title: "Add System Analysis Node"
method: POST
path: "/system_analysis/{id}/nodes"
tags: ["System Analysis"]
---

# Add System Analysis Node

`POST /system_analysis/{id}/nodes`

## Path parameters

- `id` string, required

## Request body

- AddSystemAnalysisNodeRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` AddSystemAnalysisNodeAttributes, required
    - `descriptionOverride` string
    - `hidden` boolean
    - `knowledgeEntityId` string, required
    - `labelOverride` string
    - `position` SystemAnalysisNodeDiagramPosition, required
      - `x` number, double, required
      - `y` number, double, required

## Response `200`

OK

- AddSystemAnalysisNodeResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` SystemAnalysisNode, required
    - `attributes` SystemAnalysisNodeAttributes, required
      - `descriptionOverride` string
      - `hidden` boolean, required
      - `knowledgeEntity` KnowledgeGraphEntity, required
        - `attributes` KnowledgeGraphEntityAttributes, required
          - `aliases` KnowledgeGraphSubjectAlias[], required
            - `attributes` KnowledgeGraphSubjectAliasAttributes, required
              - …
            - `id` string, required
          - `category` string, required
          - `createdAt` string, date-time, required
          - `kind` string, required
          - `latestState` KnowledgeGraphSubjectState
            - `description` string, required
            - `displayName` string, required
            - `properties` object, required
          - `updatedAt` string, date-time, required
        - `id` string, required
      - `labelOverride` string
      - `position` SystemAnalysisNodeDiagramPosition, required
        - `x` number, double, required
        - `y` number, double, required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-08-27** (v1) `eaee3040e50d` — 1 breaking, 1 info
  - removed the required property `data/attributes/knowledgeEntity/attributes/subkind` from the response with the `200` status
  - added the required property `data/attributes/knowledgeEntity/attributes/category` to the response with the `200` status
- **2026-08-18** (v1) `757c8394efdc` — 1 info
  - endpoint added
- **2026-08-17** (v1) `f01c56c8a294` — 1 breaking
  - api path removed without deprecation
- **2026-07-29** (v1) `6e29faf92044` — 1 warning, 1 info
  - removed the optional property `data/attributes/knowledgeEntity/attributes/latestEvidence` from the response with the `200` status
  - added the optional property `data/attributes/knowledgeEntity/attributes/latestState` to the response with the `200` status
- **2026-07-27** (v1) `755e232a4525` — 1 breaking, 1 info
  - removed the required property `data/attributes/knowledgeEntity/attributes/state` from the response with the `200` status
  - added the optional property `data/attributes/knowledgeEntity/attributes/latestEvidence` to the response with the `200` status

[Full history](https://skmtc.dev/rezible/apis/rezible-api/changes/system_analysis/:id/nodes/post.md)

---

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