All Products
Search
Document Center

Seri Qoder CN:Perbarui session

Last Updated:Jul 04, 2026

Perbarui judul atau metadata session Forward.

Request headers

Header

Required

Description

Authorization

Yes

Bearer <PAT>

Content-Type

Yes

application/json

Idempotency-Key

No

Kunci idempotensi opsional untuk request yang tidak aman.

Path parameters

Parameter

Type

Required

Description

session_id

string

Yes

Session ID.

Request body

Parameter

Type

Required

Description

title

string

No

Judul session baru.

metadata

object

No

Patch merge metadata. Kunci yang diberikan akan menimpa kunci yang sudah ada; kunci yang dihilangkan tetap tidak berubah.

Contoh request

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated session title",
    "metadata": {
      "source": "mobile",
      "biz_id": "ticket_123"
    }
  }'

Contoh respons

HTTP 200 OK

{
  "id": "sess_xxx",
  "type": "session",
  "identity_id": "idn_xxx",
  "template": {
    "id": "tmpl_support",
    "type": "template",
    "name": "Support assistant",
    "model": "ultimate",
    "version": 3
  },
  "source_type": "api",
  "status": "idle",
  "title": "Updated session title",
  "metadata": {
    "source": "mobile",
    "biz_id": "ticket_123"
  },
  "stats": {
    "active_seconds": 30,
    "duration_seconds": 3600
  },
  "usage": {
    "credits": 12.7
  },
  "archived_at": null,
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T12:00:00Z"
}

Field respons

Mengembalikan objek Session yang telah diperbarui.

Kesalahan

HTTP

Type

Code

Trigger

400

invalid_request_error

invalid_request

Body pembaruan tidak valid.

401

authentication_error

authentication_required

PAT tidak valid atau kedaluwarsa.

404

not_found_error

session_not_found

Session tidak ditemukan.

409

conflict_error

session_archived

Session telah diarsipkan.

Catatan

  • config, resources, dan incremental_streaming_enabled merupakan pengaturan waktu pembuatan dan tidak dapat diubah di sini.