Atualizar uma sessão - Qoder CN Series: Central de Documentação do Alibaba Cloud

Atualize o título ou os metadados de uma sessão Forward.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Content-Type`	Sim	`application/json`
`Idempotency-Key`	Não	Chave de idempotência opcional para requisições não seguras.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`session_id`	string	Sim	ID da sessão.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`title`	string	Não	Novo título da sessão.
`metadata`	object	Não	Patch de mesclagem de metadados. As chaves fornecidas substituem as existentes; as omitidas permanecem inalteradas.

Exemplo de requisição

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"
    }
  }'

Exemplo de resposta

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"
}

Campos da resposta

Retorna o objeto Session atualizado.

Erros

HTTP	Tipo	Código	Gatilho
400	`invalid_request_error`	`invalid_request`	Corpo de atualização inválido.
401	`authentication_error`	`authentication_required`	PAT inválido ou expirado.
404	`not_found_error`	`session_not_found`	Sessão inexistente.
409	`conflict_error`	`session_archived`	Sessão arquivada.

Observações

Os parâmetros config, resources e incremental_streaming_enabled são definidos apenas na criação e não podem ser alterados nesta operação.