Skip to main content

Actualizar/Versionar documento

POST 
/documents/:id

Descripción​

Crea una nueva versión de un documento existente en S3, manteniendo historial completo.

Requisitos de Acceso​

  • Autenticación: Token JWT válido
  • Rol mínimo: Administrador (isAdmin)

Comportamiento de Versionado​

  • Número de versión: Se incrementa automáticamente
  • Archivos anteriores: Se conservan en S3
  • Nuevos archivos: Se suben con nueva versión
  • Estado: Se reinicia a pending para revisión

Restricciones​

  • Máximo 6 nuevos archivos por versión (10MB c/u)
  • Mismos formatos soportados que creación
  • El documento original debe existir

Ejemplo de Uso​

curl -X POST \
  -H "Authorization: Bearer {token}" \
  -F "name=Contrato de Servicios v2" \
  -F "files=@contrato_actualizado.pdf" \
  https://api.example.com/v1/documents/5f8d3b7a9c2d1e0f4a6b5c4d

Flujo Técnico​

  1. Validación de permisos y UTC
  2. Verificación de documento existente
  3. Subida de nuevos archivos a S3
  4. Creación de nueva versión en BD
  5. Actualización de referencias

Request​

Responses​

Documento actualizado exitosamente