Reference
Entities API
Entity extraction and discovery endpoints
Entity extraction and discovery endpoints
GET /api/entities
List entities
Query parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | No | Filter by entity type (e.g., PERSON, TECHNOLOGY) |
limit | integer | No | Maximum number of entities to return |
offset | integer | No | Number of entities to skip |
Response: 200 OK
| Field | Type | Required | Description |
|---|---|---|---|
data | EntityNode[] | No | |
pagination | object | No |
Example:
curl -X GET "https://api.memnexus.ai/api/entities" \
-H "Authorization: Bearer cmk_live_xxx.yyy"GET /api/entities/{id}
Get entity by ID
Path parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The entity ID |
Response: 200 OK
| Field | Type | Required | Description |
|---|---|---|---|
data | EntityNode | No |
Example:
curl -X GET "https://api.memnexus.ai/api/entities/mem_abc123" \
-H "Authorization: Bearer cmk_live_xxx.yyy"GET /api/entities/{id}/memories
Get memories mentioning entity
Path parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The entity ID |
Query parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Maximum number of memories to return |
offset | integer | No | Number of memories to skip |
Response: 200 OK
| Field | Type | Required | Description |
|---|---|---|---|
data | object[] | No | |
pagination | object | No |
Example:
curl -X GET "https://api.memnexus.ai/api/entities/mem_abc123/memories" \
-H "Authorization: Bearer cmk_live_xxx.yyy"