Upload & Delete Documents

​

Upload Document

curl -X POST https://api.example.com/api/upload \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/document.pdf" \
  -F "folder=soat" \
  -F "placa=ABC123"

​

HTTP Request

POST /api/upload

​

Content Type

multipart/form-data

​

Form Data Parameters

​

Response

​

Success Response

{
  "path": "soat/ABC123_2026.pdf",
  "message": "Archivo subido correctamente"
}

​

Error Responses

{
  "error": "No se proporcionó archivo"
}

{
  "error": "Folder y placa son requeridos"
}

{
  "error": "Folder no válido"
}

{
  "error": "Solo se permiten archivos PDF"
}

​

Implementation Details

• Files are stored in the vehiculos_docs bucket in Supabase Storage
• File names are generated as {sanitizedPlaca}_{currentYear}.pdf
• The upsert: true option allows overwriting existing files
• Files are cached for 1 hour (cacheControl: '3600')
• Only alphanumeric characters and hyphens are allowed in the sanitized placa

​

Delete Document

curl -X DELETE https://api.example.com/api/upload \
  -H "Content-Type: application/json" \
  -d '{
    "path": "soat/ABC123_2026.pdf"
  }'

​

HTTP Request

DELETE /api/upload

​

Request Body

​

Response

​

Success Response

{
  "message": "Archivo eliminado correctamente"
}

​

Error Responses

{
  "error": "Path es requerido"
}

{
  "error": "Detailed error message from Supabase"
}

​

Implementation Details

• Files are removed from the vehiculos_docs bucket in Supabase Storage
• The path must match the exact storage path returned when the file was uploaded
• If the file doesn’t exist, the operation may still return success