---
title: "Import nodes from CSV"
method: POST
path: "/api/import/csv"
---

# Import nodes from CSV

`POST /api/import/csv`

Upload a CSV file to create nodes. The first row is treated as column headers
(property names). Each subsequent row creates one node with the specified label.
Property types are auto-detected (integer → float → boolean → string).

## Response `200`

Import successful

- CsvImportResponse
  - `status` string
  - `nodes_created` integer
  - `label` string
  - `columns` string[]

## Other responses

- `400` — Import error (missing fields, parse error)

## 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/csv/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)