Skip to main content
POST
/
graph
/
create
JavaScript
import Morphik from 'morphik';

const client = new Morphik({
  apiKey: 'My API Key',
});

const graph = await client.graph.create({ name: 'name' });

console.log(graph.id);
{
  "id": "<string>",
  "name": "<string>",
  "entities": [
    {
      "id": "<string>",
      "label": "<string>",
      "type": "<string>",
      "properties": {},
      "document_ids": [
        "<string>"
      ],
      "chunk_sources": {}
    }
  ],
  "relationships": [
    {
      "id": "<string>",
      "source_id": "<string>",
      "target_id": "<string>",
      "type": "<string>",
      "document_ids": [
        "<string>"
      ],
      "chunk_sources": {}
    }
  ],
  "metadata": {},
  "system_metadata": {},
  "document_ids": [
    "<string>"
  ],
  "filters": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "folder_name": "<string>",
  "end_user_id": "<string>",
  "app_id": "<string>"
}

Headers

​
authorization
string

Body

application/json

Request model for creating a graph

​
name
string
required

Name of the graph to create

​
filters
object | null

Optional metadata filters to determine which documents to include

​
documents
string[] | null

Optional list of specific document IDs to include

​
prompt_overrides
object | null

Optional customizations for entity extraction and resolution prompts Container for graph-related prompt overrides.

Use this class when customizing prompts for graph operations like create_graph() and update_graph(), which only support entity extraction and entity resolution customizations.

This class enforces that only graph-relevant override types are used.

Example:
{
  "entity_extraction": {
    "examples": [{ "label": "Example", "type": "ENTITY" }],
    "prompt_template": "Extract entities from the following text: {content}\n{examples}"
  }
}
​
folder_name

Optional folder scope for the operation. Accepts a single folder name or a list of folder names.

​
end_user_id
string | null

Optional end-user scope for the operation

Response

Successful Response

Represents a knowledge graph

​
name
string
required
​
id
string
​
entities
Entity · object[]
​
relationships
Relationship · object[]
​
metadata
object
​
system_metadata
object
​
document_ids
string[]
​
filters
object | null
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
folder_name
string | null
​
end_user_id
string | null
​
app_id
string | null
⌘I