Status da thread

Marca uma conversa como aberta, resolvida ou arquivada.

Use esta rota para o cliente encerrar um assunto ("Marcar como resolvida"), arquivá-lo ou reabri-lo. A mudança vale para os dois lados da conversa.

open (A)→resolved (R)→archived (C)

PATCH/api/v1/storefront/messages/threads/{id}/statusCliente

Mudar o status da thread

Parâmetros de caminho

iduuidobrigatório

Id da thread.

Corpo da requisição

statusstringobrigatório

openresolvedarchived

Novo estado: open grava A, resolved grava R e archived grava C.

Exemplo de requisição

bash

curl -X PATCH "$BASE_URL/api/v1/storefront/messages/threads/$THREAD_ID/status" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"resolved"}'

Resposta

200Status atualizado

json

{
  "id": "3f0d6c0e-2a8b-4a40-9f69-4a0f7d1e6a77",
  "subject": "Dúvida sobre o pedido PEDIDO-20261010-0004",
  "status": "R",
  "customer_user_id": "f12f30a9-cbec-40ba-98f1-b7fa8f2e8e10",
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "vendor_name": "Casa do Café",
  "customer_name": "Maria Souza",
  "last_message_preview": "Seu pedido sai amanhã.",
  "last_message_at": "2026-10-11T18:30:00Z",
  "unread_count": 0,
  "created_at": "2026-10-11T17:00:00Z",
  "updated_at": "2026-10-11T19:20:00Z",
  "messages": []
}

A resposta é a thread completa, com os mesmos campos de Ler a thread na forma sem paginação (o vetor messages traz a conversa inteira).

Erros

Status	Quando	Corpo
400	`id` não é UUID.	`{"error":"invalid id","detail":"id must be a valid UUID"}`
400	JSON inválido.	`{"error":"invalid request body","detail":"..."}`
400	`status` fora dos três valores.	`{"error":"status must be one of: open, resolved, archived"}`
401	Sem token, ou token inválido.	`{"error":"missing authorization header"}`
403	A thread não é do cliente (ou não existe).	`{"error":"you are not a participant of this thread"}`
404	A thread deixou de existir durante a operação.	`{"error":"thread not found"}`

Veja também