Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
POST /v1/sessions/{session_id}
Updates mutable attributes of a session (such as title or metadata). Only fields that need to be modified should be included.
Path parameters
| Parameter | Type | Description |
|---|
session_id | string | Session ID with the sess_ prefix |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer $QODER_PAT |
Content-Type | Yes | application/json |
Request body
| Field | Type | Required | Description |
|---|
title | string | No | New session title |
metadata | object | No | New metadata (full replacement) |
Example request
curl -X POST https://openapi.qoder.sh/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"title": "New title",
"metadata": {"priority": "high"}
}'
Example response
HTTP 200 OK
Returns the updated Session object. The updated_at field is refreshed.
{
"id": "sess_019e3bb1e8c171fd9abbb1477ffb84cc",
"type": "session",
"title": "New title",
"status": "idle",
"updated_at": "2026-05-18T15:26:25.865347Z"
}
Errors
| HTTP | Type | Trigger |
|---|
| 400 | invalid_request_error | Malformed request body |
| 401 | authentication_error | PAT invalid or expired |
| 404 | not_found_error | Session does not exist |
