<span id="更新-llm-会话记录"></span>

# Update an LLM session record

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

Update a session title or configuration text with an optional original-title condition.


```http
PUT https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/llm/sessions/{session_id}
```

<span id="调用前准备"></span>

## Before you call this API

Set `BASE_URL` to the product API prefix `https://api.moi.matrixorigin.cn/v5`; use the corresponding product API URL for a dedicated deployment.

[Configure workspace identity and variables in the same environment](objects.md#request-prerequisites). Read details first and save the current title and configuration to retain.

<span id="请求"></span>

## Request

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
curl --request PUT \
  "$BASE_URL/workspaces/$WORKSPACE_ID/llm/sessions/$SESSION_ID" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID" \
  --header "Content-Type: application/json" \
  --data-raw '{"title":"更新后的标题","expected_title":"临时会话"}'
```

:::::
:::::{tab-item} Parameters

| Parameter | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `workspace_id` | Path | string | Yes | Target workspace, matching X-Workspace-ID. |
| `session_id` | Path | integer | Yes | Positive integer ID returned by this service. |
| `title` | Body | string | No | New title; updates only for a nonempty string. |
| `config` | Body | string | No | New configuration text; updates only for a nonempty string. |
| `expected_title` | Body | string or null | No | A non-null string is the original-title condition. An empty string is also a valid condition. |

Omission, null, or an empty string for title/config retains the original value. Omitted or null expected_title skips the original-title check. A mismatch leaves data unchanged but still returns HTTP 200 and the current session. Compare the returned title or configuration to confirm an update. Success does not imply the condition matched, and there is no 409 conflict to wait for. Request source is unused in this update.

:::::
::::::
:::::::

<span id="成功响应"></span>

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "code": 0,
  "data": {
    "id": 41,
    "title": "更新后的标题",
    "source": "moi",
    "user_id": "user-example",
    "config": "{}",
    "created_at": 1794445200,
    "updated_at": 1794445200
  }
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | 0 on success; HTTP status 200. |
| `data` | object | [Session record](objects.md#session-object). |

:::::
::::::
:::::::

<span id="错误响应"></span>

## Error responses

[Error formats and read scope](objects.md#error-contract) describes distinct identity, parameter, resource-read, and storage failure outcomes.
