Skip to navigation

Add edges

Adds 1 to 100 edges. A name creates a node when deduplicate is false. When deduplicate is true, Zep matches a node by name first. Example: {“edges”:[{“fact”:“Ada works at Acme Corp”,“fact_name”:“WORKS_AT”,“source_node”:{“uuid”:“f47ac10b-58cc-4372-a567-0e02b2c3d479”},“target_node”:{“uuid”:“f47ac10b-58cc-4372-a567-0e02b2c3d480”}},{“fact”:“Ada leads a team”,“fact_name”:“LEADS”,“source_node”:{“name”:“Ada Lovelace”,“labels”:[“Person”]},“target_node”:{“name”:“Engineering”,“labels”:[“Department”]}}],“deduplicate”:false}

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

graph_uuidstringRequired
Graph UUID

Request

Request body
edgeslist of objectsRequired
The edges to add to the graph. The request accepts 1 to 100 edges.
deduplicatebooleanOptional
When true, Zep compares each edge with graph edges and can merge a duplicate or invalidate a contradicted edge. This adds an LLM call per edge. The default is false.

Response

Accepted
edgeslist of objectsOptional

The accept-time acknowledgements in request order.

taskobjectOptional
The asynchronous task that tracks edge creation and indexing.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error