Get Chat Session
This page uses Nexus's generated request and response schema. Requests still require the correct account, workspace, and resource permissions.
/chat/get-chat-session/{session_id}curl --request GET 'https://school.narb.cc/api/chat/get-chat-session/{session_id}' \
--header 'Authorization: Bearer YOUR_TOKEN'This builds a request example. Fill in required query values, then replace path placeholders and YOUR_TOKEN in your own environment. Use a token for a user with access to this workspace. Responses and permissions depend on your account and deployment. Never paste a private token into documentation.
Download the Nexus OpenAPI schema ↗
Import the schema into your API client. It describes the backend source; enabled routes depend on your workspace.
Authentication and scope#
Send requests to the workspace that owns the resource. Authentication does not by itself grant a school membership, class assignment, or administrator permission. School endpoints apply their role and class checks on the server.
Use a credential issued for that workspace with only the permissions your integration needs. Keep it on your server. Do not place credentials in a public website or a shared skill.
Parameters#
| Name | Location | Required | Type |
|---|---|---|---|
session_id | path | Yes | string |
is_shared | query | No | boolean |
include_deleted | query | No | boolean |
tenant_id | query | No | string or null |
The tenant_id parameter is part of the engine schema. It does not authorize a caller to another school. Use the workspace and permissions assigned to your account.
Responses#
200#
Successful Response
{
"properties": {
"chat_session_id": {
"type": "string",
"format": "uuid",
"title": "Chat Session Id"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"persona_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Persona Id"
},
"persona_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Persona Name"
},
"personal_icon_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Personal Icon Name"
},
"messages": {
"items": {
"$ref": "#/components/schemas/ChatMessageDetail"
},
"type": "array",
"title": "Messages"
},
"time_created": {
"type": "string",
"format": "date-time",
"title": "Time Created"
},
"shared_status": {
"$ref": "#/components/schemas/ChatSessionSharedStatus"
},
"current_alternate_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Alternate Model"
},
"current_temperature_override": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Current Temperature Override"
},
"current_reasoning_effort_override": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Reasoning Effort Override"
},
"deleted": {
"type": "boolean",
"title": "Deleted",
"default": false
},
"owner_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Owner Name"
},
"packets": {
"items": {
"items": {
"$ref": "#/components/schemas/Packet"
},
"type": "array"
},
"type": "array",
"title": "Packets"
},
"current_run": {
"anyOf": [
{
"$ref": "#/components/schemas/CurrentRunInfo"
},
{
"type": "null"
}
]
},
"incognito": {
"type": "boolean",
"title": "Incognito",
"default": false
}
},
"type": "object",
"required": [
"chat_session_id",
"description",
"persona_name",
"personal_icon_name",
"messages",
"time_created",
"shared_status",
"current_alternate_model",
"current_temperature_override",
"current_reasoning_effort_override",
"packets"
],
"title": "ChatSessionDetailResponse"
}422#
Validation Error
{
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}Access and error handling#
A signed-out or expired session needs authentication. A denied request can mean the account lacks permission, class membership, an approved model, or an available allowance. Do not retry a write blindly after a network failure; first check whether it was recorded.
Treat validation errors as a request problem. Use the returned field details to correct the request. Resource identifiers do not confer access.
Schema version#
Generated from Nexus backend source fe1c3a07c793029d3d87191a68f89e481afd6bc8. Check your deployed version before integrating. Schema coverage is not a live acceptance test.