Kuenta Docs

Appearance

Eliminar archivo de firma escaneada​

DELETE
/document/{document-id}/signature-scan/{signature-id}/signature-file/{signature-file-id}/{field}

Elimina archivos específicos de firmas escaneadas, permitiendo la gestión de evidencias digitales.

Casos de Uso:

  • Corrección de errores en documentos subidos
  • Cumplimiento con políticas de retención de datos
  • Gestión de espacio de almacenamiento
  • Re-subida de documentos con mejor calidad

Validaciones de Seguridad:

  • Solo el propietario o administrador puede eliminar archivos
  • Registro de auditoría para todas las eliminaciones
  • Verificación de que la firma no esté finalizada
  • Control de permisos granular por tipo de archivo

Impacto de la Eliminación:

  • El archivo se marca como eliminado (soft delete)
  • Se mantiene registro en logs de auditoría
  • La firma puede requerir re-subida del archivo
  • Notificación automática al firmante si es necesario

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Path Parameters

document-id*

Identificador único del documento

Typestring
Required
Examplef47ac10b-58cc-4372-a567-0e02b2c3d479
formatuuid
signature-id*

Identificador único de la firma escaneada

Typestring
Required
Examplee1f20304-a5b6-7890-1234-567890abcdef
formatuuid
signature-file-id*

Identificador único del archivo de firma

Typestring
Required
Examplef2030405-0607-8901-2345-67890abcdef1
formatuuid
field*

Campo específico del archivo a eliminar

Typestring
Required
Enum
imagedocument-frontdocument-backverification
Exampleimage

Query Parameters

reason

Razón de la eliminación para auditoría

Typestring
ExampleDocumento de baja calidad, requiere nueva subida
maxLength500

Responses​

Archivo eliminado exitosamente
application/json
JSON
{
"status": "success",
"data": {
"deletedFile": {
"fileId": "f2030405-0607-8901-2345-67890abcdef1",
"field": "image",
"deletedAt": "2024-01-15T10:45:00Z",
"deletedBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"auditId": "b2c3d4e5-f607-8901-bcde-f23456789012"
},
"signature": {
"id": "e1f20304-a5b6-7890-1234-567890abcdef",
"status": "pending_file_upload",
"requiredFiles": [
[
"image",
"document-front"
]
]
}
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI