DELETE/api/uploads/videocolposcopia/{appointment_id}/files

Remover arquivo

Apaga um arquivo do armazenamento e o tira do exame.

Exige o token de acesso — como obter
Limite: 120 por minuto, por IP

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Bearer {access_token}, com o token que o login devolve.
`Content-Type`	string	Sim	application/json

Parâmetros do caminho

Nome	Tipo	Obrig.	Descrição
`appointment_id`	uuid	Sim	O agendamento.

Corpo da requisição

Nome	Tipo	Obrig.	Descrição
`url`	string	Sim	A url do arquivo, como vem na lista.

Campos da resposta

Nome	Tipo	Descrição
`message`	string	Arquivo removido com sucesso.
`removed_url`	string	O arquivo removido.
`remaining_files`	integer	Quantos arquivos o exame ainda tem.

Request URL

https://api-endosystem.imagemais.com.br/api/uploads/videocolposcopia/b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f/files

curl -X DELETE "https://api-endosystem.imagemais.com.br/api/uploads/videocolposcopia/b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f/files" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm"}'

{
  "url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm"
}

{
  "url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm"
}

Respostas

{
  "message": "Arquivo removido com sucesso",
  "removed_url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm",
  ...

{
  "message": "Arquivo removido com sucesso",
  "removed_url": "https://storage.exemplo.com/videocolposcopia/9d3f1c2a-6b7e-4a8d-9f01-23456789abcd/2026-10-20_09-30-00/7f3a9c1e.dcm",
  "remaining_files": 11
}

{
  "error": "URL do arquivo não informada"
}

{
  "error": "URL do arquivo não informada"
}

{
  "error": "Arquivo não encontrado neste exame"
}

{
  "error": "Arquivo não encontrado neste exame"
}

{
  "error": "Agendamento não encontrado"
}

{
  "error": "Agendamento não encontrado"
}

{
  "error": "Erro ao remover arquivo do armazenamento"
}

{
  "error": "Erro ao remover arquivo do armazenamento"
}

{
  "error": "Muitas requisições. Tente novamente em instantes."
}

{
  "error": "Muitas requisições. Tente novamente em instantes."
}

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}