- Graphwise Platform Documentation
- Graphwise API Endpoints
- GraphRAG
- Conversations Service API
- The Conversations Service API - Conversation Management
The Conversations Service API - Conversation Management
30/09/2026
GraphRAG 1.3.0
This section covers the following endpoints:
GET /conversationsGET /conversations/{id}DELETE /conversations/{id}GET /conversations/{id}/questionsGET /conversations/{id}/questions/{qid}POST /conceptDetails
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?"
]
}
]
}
}Retrieves concept details for a list of concepts.
POST /conceptDetails
curl --url 'https://api.example.com/conceptDetails' \
-H 'Authorization: Bearer <access_token>' \ -H 'Content-Type: application/json' \
--data-raw '{"conceptUris":["https://example.concept.uri"]}'{
"concepts": [
{
"categories": [
{
"altLabels": null,
"definitions": [],
"examples": null,
"hiddenLabels": [],
"label": "Example concept scheme",
"scopeNotes": [],
"uri": "https://example.scheme.uri"
}
],
"childConcepts": [],
"customProperties": {
"attributes": {},
"relations": {}
},
"details": {
"altLabels": [],
"definitions": [],
"examples": [],
"hiddenLabels": [],
"scopeNotes": []
},
"equivalentConcepts": null,
"label": "Example concept",
"parentConcepts": [
{
"altLabels": null,
"definitions": [],
"examples": [],
"hiddenLabels": [],
"label": "Example parent concept",
"scopeNotes": [],
"uri": "https://example.parentconcept.uri"
}
],
"relatedConcepts": [],
"similarConcepts": null,
"uri": "https://example.concept.uri"
}
],
"customPropertyDetails": {
"https://example.com/CustomRelation": {
"label": "Some custom relation",
"isRelation": true
}
}
}Field | Type | Details |
|---|---|---|
|
| Details for all the requested concepts |
|
| Details related to custom relations or attributes |