POST
/
v1
/
storage
/
import
/
cURL
curl --request POST \
  --url https://api.unize.org/v1/storage/import/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "graph_name": "<string>",
  "cypher": "<string>",
  "use_file_upload": false
}'
{
  "graph_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "upload_presigned_url": "<string>"
}

Authorizations

Authorization
string
header
required

Send the API generated from the Playground:

  • Authorization: <api_key>

Body

graph_name
string
required

A unique identifier or label for the knowledge graph being imported. It should be descriptive enough to indicate the graph's content, purpose, or source (e.g., 'medical_research_graph' or 'customer_support_kg').

Maximum length: 200
graph_id
string<uuid>

An alphanumeric string that uniquely identifies a knowledge graph. Provide the graph_id of an existing knoweldge graph to update it with the imported data. If omitted, a new knoweldge graph will be created instead.

cypher
string

The Cypher Query string representing the knowledge graph to be imported. This string should contain valid Cypher commands that define the nodes and relationships of the graph. Ignored if use_file_upload is true.

Maximum length: 500000
use_file_upload
boolean
default:false

If true, server will return a presigned URL for uploading a Cypher file.

Response

graph_id
string<uuid>
required

An alphanumeric string that uniquely identifies the updated or imported knowledge graph.

upload_presigned_url
string

The URL where the to-be-imported graph should be uploaded to.