- Graphwise Platform Documentation
- Graphwise API Endpoints
- GraphRAG
- Conversations Service API
- The Conversations Service API - Conversation Management
The Conversations Service API - Conversation Management
20/02/2026
This section covers the following endpoints:
GET /conversationsGET /conversations/{id}DELETE /conversations/{id}GET /conversations/{id}/questionsGET /conversations/{id}/questions/{qid}
Lists all conversations for the current user.
GET /conversations
curl "https://api.example.com/conversations" \ -H "Authorization: Bearer <access_token>"
{
"conversations": [
{
"conversationId": "550e8400-e29b-41d4-a716-446655440000",
"userId": "user123",
"label": "What is GraphRAG?",
"createTime": "2024-01-28T10:30:00Z",
"mostRecentQuestionTime": "2024-01-28T10:45:00Z"
},
{
"conversationId": "661e8400-e29b-41d4-a716-446655440001",
"userId": "user123",
"label": "How does vector search work?",
"createTime": "2024-01-27T14:20:00Z",
"mostRecentQuestionTime": "2024-01-27T14:25:00Z"
}
]
}Field | Type | Details |
|---|---|---|
| string | Unique conversation identifier (UUID) |
| string | User who created the conversation |
| string | First question (used as conversation title) |
| string | ISO 8601 timestamp when the conversation started |
| string | ISO 8601 timestamp when the last question was asked |
| object | Conversation configuration (reserved for future use) |
Retrieves a specific conversation by ID.
GET /conversations/{conversation_id}Parameter | Type | Required | Details |
|---|---|---|---|
| string | Yes | Conversation UUID |
curl "https://api.example.com/conversations/550e8400-e29b-41d4-a716-446655440000" \ -H "Authorization: Bearer <access_token>"
{
"conversation": {
"conversationId": "550e8400-e29b-41d4-a716-446655440000",
"userId": "user123",
"label": "What is GraphRAG?",
"createTime": "2024-01-28T10:30:00Z",
"mostRecentQuestionTime": "2024-01-28T10:45:00Z"
}
}Deletes a conversation and all questions asked.
DELETE /conversations/{conversation_id}curl -X DELETE "https://api.example.com/conversations/550e8400-e29b-41d4-a716-446655440000" \ -H "Authorization: Bearer <access_token>"
{
"message": "Conversation deleted successfully"
}HTTP Code | Details |
|---|---|
| Conversation not found |
| Unauthorized |
Lists all questions within a conversation.
GET /conversations/{conversation_id}/questionscurl "https://api.example.com/conversations/550e8400-e29b-41d4-a716-446655440000/questions" \ -H "Authorization: Bearer <access_token>"
{
"questions": [
{
"questionId": "q1-uuid",
"createTime": "2024-01-28T10:30:00Z",
"status": "COMPLETED",
"messages": [
{
"messageType": "ANSWER",
"payload": "GraphRAG is a technology...",
"createTime": "2024-01-28T10:30:05Z"
},
{
"messageType": "SOURCES",
"payload": [{"uri": "docs/graphrag-overview.pdf", "title": "GraphRAG Overview"}]
}
]
},
{
"questionId": "q2-uuid",
"createTime": "2024-01-28T10:45:00Z",
"status": "COMPLETED",
"messages": [...]
}
]
}Status | Details |
|---|---|
IN_PROGRESS | Question is being processed |
COMPLETED | Answered successfully |
CLIENT_DISCONNECT | Client disconnected during processing |
ERROR_GENERAL | General error occurred |
ERROR_TIMEOUT | Processing timed out |
Retrieves a specific question with all its messages.
GET /conversations/{conversation_id}/questions/{question_id}curl "https://api.example.com/conversations/550e8400-e29b-41d4-a716-446655440000/questions/q1-uuid" \ -H "Authorization: Bearer <access_token>"
{
"question": {
"questionId": "q1-uuid",
"createTime": "2024-01-28T10:30:00Z",
"status": "COMPLETED",
"messages": [
{
"messageId": "msg-uuid-1",
"messageType": "ANSWER",
"payload": "GraphRAG is a technology that combines...",
"conversationId": "550e8400-e29b-41d4-a716-446655440000",
"questionId": "q1-uuid",
"createTime": "2024-01-28T10:30:05Z"
},
{
"messageId": "msg-uuid-2",
"messageType": "SOURCES",
"payload": [
{
"uri": "docs/graphrag-overview.pdf",
"title": "GraphRAG Overview"
}
]
},
{
"messageId": "msg-uuid-3",
"messageType": "FOLLOWUPS",
"payload": [
"How does GraphRAG improve accuracy?",
"What are knowledge graphs?"
]
}
]
}
}