Skip to main content

PATCH Salvar URL do Áudio

Registra o áudio enviado ao storage como arquivo da pré-consulta. Cada chamada cria um novo arquivo (a pré-consulta pode ter vários áudios).

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_preconsultations.

Antes desta rota

Use a publicUrl retornada em Gerar URL Pré-assinada para Áudio, depois de concluir o PUT. O servidor não confere se a URL existe no storage.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/pre-consultations/{id}/audio-url

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID da pré-consulta

Corpo da Requisição​

CampoTipoObrigatórioDescrição
urlstring✅URL pública do áudio

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/pre-consultations/29/audio-url' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://storagedev.imagemaislaboratorio.com.br/pre-consultation-audio/29/5328dc7d9e2c67a63b26cd31b2e9783e"
}'

Respostas​

200 Sucesso​

Retorna o registro do arquivo criado (fileType: "pre-consultation-audio").

{
"id": 166,
"url": "https://storagedev.imagemaislaboratorio.com.br/pre-consultation-audio/29/5328dc7d9e2c67a63b26cd31b2e9783e",
"fileType": "pre-consultation-audio",
"name": "Áudio da pré-consulta da data: 29/09/2026 19:53:42",
"createdAt": "2026-09-29T22:53:42.038Z",
"updatedAt": "2026-09-29T22:53:42.041Z",
"deletedAt": null,
"accountId": null
}

400 Bad Request​

Retornado quando url não é enviada.

{
"message": [
"url must be a string"
],
"error": "Bad Request",
"statusCode": 400
}

404 Pré-consulta não encontrada​

Retornado quando o id não existe, foi excluído ou pertence a outra conta.

{
"message": "Pré-consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}

500 Erro ao salvar​

Retornado quando a gravação do arquivo falha.

{
"message": "Erro ao salvar URL do áudio",
"error": "Internal Server Error",
"statusCode": 500
}