Atualize atributos da sessão, como título e metadados. Inclua apenas os campos que deseja modificar.
Parâmetros de caminho
|
Parâmetro |
Tipo |
Descrição |
|
session_id |
string |
ID da sessão com o prefixo sess_ |
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Bearer $QODER_PAT |
|
Content-Type |
Sim |
application/json |
Corpo da requisição
|
Campo |
Tipo |
Obrigatório |
Descrição |
|
title |
string |
Não |
Novo título da sessão |
|
metadata |
object |
Não |
Novos metadados (substituição completa) |
Exemplo de requisição
curl -X POST https://api.qoder.com.cn/api/v1/cloud/sessions/sess_019e3bb1e8c171fd9abbb1477ffb84cc \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"title": "New title",
"metadata": {"priority": "high"}
}'Exemplo de resposta
HTTP 200 OK
Retorna o objeto de sessão atualizado com o timestamp updated_at renovado.
{
"agent": {
"created_at": "2026-05-27T08:22:05.558081Z",
"default_environment": "",
"description": "",
"id": "agent_019e6886cdf5778098368adde92a2a02",
"instructions": "You are a general-purpose assistant capable of research, writing code, running commands, and using tools end-to-end to complete tasks.",
"mcp_servers": [],
"model": "ultimate",
"name": "Hello World Agent",
"system": "You are a general-purpose assistant capable of research, writing code, running commands, and using tools end-to-end to complete tasks.",
"tools": [
{
"enabled_tools": ["WebFetch", "WebSearch", "Bash", "Glob", "Read", "Grep", "Write", "Edit"],
"type": "agent_toolset_20260401"
}
],
"type": "agent",
"updated_at": "2026-05-27T10:09:09.542948Z",
"version": 3
},
"agent_id": "agent_019e6886cdf5778098368adde92a2a02",
"created_at": "2026-05-27T15:30:48.336828Z",
"environment_id": "env_019e6954e74770d6bce983cdb53be448",
"id": "sess_019e6a0f4d9170a989eee39f6685f3fb",
"memory_store_ids": [],
"resources": [
{
"file_id": "file_019e6a18dc0978e9a2104c9b269748ac",
"path": "/data/data/data/file_019e6a18dc0978e9a2104c9b269748ac",
"type": "file"
}
],
"status": "idle",
"title": "doc-test-title",
"turn_status": "idle",
"type": "session",
"updated_at": "2026-05-28T02:09:42.156418Z",
"vault_ids": []
}Observações
O objeto agent aninhado não inclui os campos archived/archived_at (diferentemente da resposta de nível superior do GET /agents).
Erros
|
HTTP |
Tipo |
Gatilho |
|
400 |
invalid_request_error |
Corpo da requisição malformado |
|
401 |
authentication_error |
PAT inválido ou expirado |
|
404 |
not_found_error |
A sessão não existe |
Consulte Erros para ver o envelope completo de erros.