curl --request GET \
--url 'https://api.nsr.stateset.com/api/v1/conversations/{id}' \
--header 'X-API-Key: YOUR_API_KEY'
{
"conversation": {
"archived_at": "string",
"created_at": "string",
"id": "string",
"metadata": null,
"session_id": "string",
"tenant_id": "string",
"title": "string",
"updated_at": "string",
"user_id": "string",
"workflow_id": "string"
},
"messages": [
{
"analysis": null,
"completion": null,
"content": "string",
"conversation_id": "string",
"created_at": "string",
"id": 1,
"role": "string",
"token_usage": null
}
]
}
Get a conversation with all its messages.
Required scope: read
GET
/
api
/
v1
/
conversations
/
{id}
curl --request GET \
--url 'https://api.nsr.stateset.com/api/v1/conversations/{id}' \
--header 'X-API-Key: YOUR_API_KEY'
{
"conversation": {
"archived_at": "string",
"created_at": "string",
"id": "string",
"metadata": null,
"session_id": "string",
"tenant_id": "string",
"title": "string",
"updated_at": "string",
"user_id": "string",
"workflow_id": "string"
},
"messages": [
{
"analysis": null,
"completion": null,
"content": "string",
"conversation_id": "string",
"created_at": "string",
"id": 1,
"role": "string",
"token_usage": null
}
]
}
Required scope:
read
Path parameters
string
required
Conversation ID
Response
ConversationWithMessages
Conversation
required
Show Conversation
Show Conversation
string
Archive timestamp (RFC3339), if soft-deleted
string
required
Creation timestamp (RFC3339)
string
required
Unique conversation ID
object
required
Arbitrary metadata
string
Linked reasoning session ID
string
required
Tenant (organization) that owns this conversation
string
required
Human-readable title
string
required
Last update timestamp (RFC3339)
string
Optional user who created the conversation
string
required
Workflow ID controlling agent behavior
ConversationMessage[]
required
Messages ordered by creation time
Show ConversationMessage
Show ConversationMessage
object
Optional analysis payload from NSR
object
Optional completion metadata
string
required
Message text content
string
required
Parent conversation ID
string
required
Message creation timestamp (RFC3339)
integer (int64)
required
Auto-increment message ID
string
required
Message role: user, assistant, or system
object
Optional token usage breakdown
Status codes
| Code | Meaning |
|---|---|
200 | Conversation with messages |
401 | Unauthorized — missing or invalid credentials |
403 | Forbidden — the key/token lacks the required scope |
404 | Conversation not found |
429 | Rate limited — see Retry-After / X-RateLimit-Reset |
503 | Database not configured |
curl --request GET \
--url 'https://api.nsr.stateset.com/api/v1/conversations/{id}' \
--header 'X-API-Key: YOUR_API_KEY'
{
"conversation": {
"archived_at": "string",
"created_at": "string",
"id": "string",
"metadata": null,
"session_id": "string",
"tenant_id": "string",
"title": "string",
"updated_at": "string",
"user_id": "string",
"workflow_id": "string"
},
"messages": [
{
"analysis": null,
"completion": null,
"content": "string",
"conversation_id": "string",
"created_at": "string",
"id": 1,
"role": "string",
"token_usage": null
}
]
}