---
title: "Import nodes from JSON"
method: POST
path: "/api/import/json"
---

# Import nodes from JSON

`POST /api/import/json`

Create nodes from an array of JSON objects. Each object becomes one node
with the specified label. Object keys become property names; values must be
string, number, or boolean (other types are silently skipped).

## Request body

- JsonImportRequest
  - `label` string, required — Node label to assign to all created nodes
  - `nodes` object[], required — Array of JSON objects, each becoming a node
  - `graph` string — Target graph/tenant name (default: 'default')

## Response `200`

Import successful

- JsonImportResponse
  - `status` string
  - `nodes_created` integer
  - `label` string

## Other responses

- `400` — Import error (missing label, invalid data)

## Changes

- **2026-03-13** `af3b694476b3` — 1 info
  - added the new optional request property `graph`
- **2026-03-09** `412861a58f2c` — 1 info
  - endpoint added
- **2026-02-21** `5b9d1ed71ed1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api/changes/api/import/json/post.md)

---

[API](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api.md) · [All operations](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/samyama-ai/samyama-graph-database-api/revisions/7f3d37bbc2cd/schema)