Execução
Listar as mensagens de uma conversa
Devolve o fio da conversa na ordem em que aconteceu, com o modelo, os tokens e as ferramentas que cada resposta chamou. A página vai até 500 mensagens.
Autorização
bearer conversations:readAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: conversations:read
Parâmetros de caminho
conversation_id*string
Id da conversa
Parâmetros de consulta
cursor?string
Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.
limit?integer
Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.
Formato
int32Intervalo
0 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/conversations/string/messages"{ "data": [ { "content": "string", "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "index": 0, "latency_ms": 0, "model": "string", "role": "user", "streamed": true, "tool_calls": [ { "arguments": {}, "call_id": "string", "is_error": true, "name": "string", "result": "string", "status": "started" } ], "truncated": true, "usage": null } ], "page": { "has_more": true, "next_cursor": "string" }}