POST Enviar Mensagem na Thread (Legado)
Envia mensagem para a thread da consulta. Use POST consultation/:consultationId/conversation/message.
Rota legada
Mantida por compatibilidade com o fluxo antigo baseado em threads da OpenAI. Prefira as rotas de conversa da consulta.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Sem permissão específica
Não exige @CheckPermissions — basta estar autenticado.
Endpoint
POST https://api-dev.imagemais.com.br/api/ai/consultation/{consultationId}/thread/message
Parâmetros de Rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
consultationId | number | ✅ | ID da consulta |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
content | string | ✅ | não vazio | Texto da mensagem |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/ai/consultation/1/thread/message' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"content": "Conteúdo de exemplo"
}'
Respostas
201 Sucesso
[
{
"role": "user",
"content": "Resuma a consulta em uma frase.",
"metadata": {}
}
]
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"content must be a string",
"content should not be empty"
],
"error": "Bad Request",
"statusCode": 400
}
Outras mensagens possíveis:
Validation failed (numeric string is expected)Esta consulta ainda não foi migrada para a nova API. Rode a migração de threads legadas.
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}
404 Não encontrado
{
"message": "Consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}