Conversations API

Conversation tracking and analysis endpoints

GET /api/conversations

List conversations

Query parameters:

Parameter	Type	Required	Description
limit	integer	No	Maximum number of conversations to return
offset	integer	No	Number of conversations to skip
since	string	No	Return only conversations created after this timestamp (ISO 8601 format)
sortBy	lastActivityAt \	createdAt \	memoryCount
order	asc \	desc	No
minMemories	integer	No	Return only conversations with at least this many memories (filters out empty init conversations)

Response: 200 List of conversations retrieved successfully

Field	Type	Required	Description
data	Conversation[]	No
pagination	object	No

Example:

curl -X GET "https://api.dev.memnexus.ai/api/conversations" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

POST /api/conversations

Create conversation

Request body:

Field	Type	Required	Description
title	string	Yes	Conversation title
summary	string	No	Optional conversation summary

Response: 201 Conversation created successfully

Field	Type	Required	Description
data	Conversation	No

Example:

curl -X POST "https://api.dev.memnexus.ai/api/conversations" \
  -H "Authorization: Bearer cmk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{}'

---

GET /api/conversations/{conversationId}

Get conversation summary

Path parameters:

Parameter	Type	Required	Description
conversationId	string	Yes	The conversation ID

Response: 200 Conversation retrieved successfully

Field	Type	Required	Description
data	Conversation	No

Example:

curl -X GET "https://api.dev.memnexus.ai/api/conversations/conv_abc123" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

DELETE /api/conversations/{conversationId}

Delete conversation

Path parameters:

Parameter	Type	Required	Description
conversationId	string	Yes	The conversation ID

Response: 204 Conversation deleted successfully

Example:

curl -X DELETE "https://api.dev.memnexus.ai/api/conversations/conv_abc123" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

GET /api/conversations/{conversationId}/timeline

Get conversation timeline

Path parameters:

Parameter	Type	Required	Description
conversationId	string	Yes	The conversation ID

Response: 200 Timeline retrieved successfully

Field	Type	Required	Description
data	Memory[]	No
count	integer	No

Example:

curl -X GET "https://api.dev.memnexus.ai/api/conversations/conv_abc123/timeline" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

POST /api/conversations/by-topic

Find conversations by topic

Request body:

Field	Type	Required	Description
topicId	string	Yes
limit	integer	No

Response: 200 Conversations retrieved successfully

Field	Type	Required	Description
data	Conversation[]	No
count	integer	No
metadata	object	No

Example:

curl -X POST "https://api.dev.memnexus.ai/api/conversations/by-topic" \
  -H "Authorization: Bearer cmk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{}'

---

POST /api/conversations/search

Search conversations

Request body:

Field	Type	Required	Description
query	string	Yes
limit	integer	No

Response: 200 Search results retrieved successfully

Field	Type	Required	Description
data	Conversation[]	No
count	integer	No

Example:

curl -X POST "https://api.dev.memnexus.ai/api/conversations/search" \
  -H "Authorization: Bearer cmk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{}'

---