Semantic Endpoints
Manage entities and relationships in the knowledge graph. Semantic memory stores structured facts as entities connected by typed relationships, enabling agents to reason over domain knowledge.
Overview
The semantic API provides endpoints for managing entities (nodes) and relationships (edges) in the knowledge graph. Entities have a type, name, and properties. Relationships connect two entities with a labeled edge and optional properties.
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/entities | Create a new entity |
GET | /v1/entities | List entities |
GET | /v1/entities/:id | Get a specific entity |
PUT | /v1/entities/:id | Update an entity |
DELETE | /v1/entities/:id | Delete an entity |
POST | /v1/entities/search | Search entities |
POST | /v1/relationships | Create a relationship |
GET | /v1/relationships | List relationships |
DELETE | /v1/relationships/:id | Delete a relationship |
Create Entity
List Entities
Get Entity
Update Entity
Delete Entity
Cascading delete
Deleting an entity also removes all relationships connected to it. Make sure you understand the impact before deleting entities that are heavily connected in the graph.
