6e297e21afca

latestSwagger 2.0raw.githubusercontent.com2026-08-13320250855.0 KB
会话

更新会话

更新会话属性

put/sessions/{id}

Path parameters

idstring required

会话ID

Request body

created_atstring
descriptionstring

Description

idstring

ID

im_platformstring

IMPlatform is the originating IM platform (e.g. "feishu", "wecom") when this session is bound to an IM channel. It is not stored on the sessions table (it lives in im_channel_sessions) and is populated on read so the Web console can classify a session's origin folder without a list query.

is_pinnedboolean

IsPinned indicates whether the session is pinned in the list.

pinned_atstring

PinnedAt records when the session was pinned; nil when not pinned.

sandbox_config_idstring

SandboxConfigID pins which sandbox config this session's CURRENT live sandbox was created on. Empty means no live sandbox; SandboxConfigIDGlobalDefault means the deployment-wide default config.

This is an ephemeral pin that dies with the sandbox, not a permanent owner: sessions outlive sandboxes by months, so treating it as permanent would make "no session references this config" never true.

tenant_idinteger

Workspace ID

titlestring

Title

updated_atstring
user_idstring

UserID is the owner scope for this session. WeKnora user UUIDs, API external-user principals, and embed visitor principals all use this column.

Response

更新后的会话

object required