VolundOS
Referência da APIChat embutido

Ler conversa do chat embutido

A conversa de um usuário desta aplicação: `status` (`running`, `completed`, `awaiting_approval` ou `failed`), `output` (a resposta final do último turno, `null` com turno rodando ou sem resposta) e as mensagens de quem conversou e do agente, sem os passos de ferramenta. Serve para o backend guardar a resposta de cada turno sem depender do navegador. Só conversa do chat embutido desta aplicação; a de outra responde 404.

Atualizado em 04 de novembro de 2026
GET
/v1/embed/threads/{threadId}

Authorization

credencialDaAplicacao
AuthorizationBasic <token>

Credencial da aplicação vinculada, criada em Configurações > Aplicações: Authorization: Basic base64(client_id:client_secret). Use só no seu backend.

In: header

Path Parameters

threadId*string

O thread_id da conversa (o do evento volund:thread-created, de volund:ready ou da sessão).

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/embed/threads/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",  "user_id": "string",  "status": "running",  "output": "string",  "last_completed": {    "id": "string",    "output": "string"  },  "messages": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "role": "user",      "text": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ]}