Get UI protocol conversation details

Read a conversation record owned by the current user.

GET https://api.moi.matrixorigin.cn/v5/sessions/{session_id}

Before you call this API

BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.

Configure identity, workspace, and numeric record IDs in the same environment. This endpoint uses regular product authentication and rejects additional task-runtime authorization headers.

Request

curl --request GET \
  "$BASE_URL/sessions/$SESSION_ID" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

Parameter

Location

Type

Required

Description

X-Workspace-ID

Header

string

Yes

Target workspace ID.

session_id

Path

integer

Yes

Positive integer record ID owned by the current user.

If the target is missing or not owned by the current user, this detail endpoint maps to 404/ErrNotFound. Conversation tags currently return an empty array; do not use them instead of querying pinned relations.

Successful response

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": 41,
    "title": "临时会话",
    "source": "moi",
    "user_id": "user-example",
    "config": "{}",
    "tags": [],
    "created_at": 1794445200,
    "updated_at": 1794445200
  }
}

Field

Type

Description

code

string

OK on success; HTTP status200.

msg

string

OK on success.

data

object

Conversation object.

Error response

Error formats and result confirmation distinguishes detail not-found from general service errors on other endpoints.

Last updated on