Delete Document

The Delete Document endpoint removes a previously uploaded document from the Netevia system based on its file type. This endpoint targets documents associated with the authenticated user's profile, such as identity documents, business registration files, insurance records, and more. Once deleted, the document is removed from the server and the system is updated accordingly.

Endpoint

POST /Files/deleteDocument

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a customer needs to remove an outdated, incorrect, or no longer relevant document from their profile. This is useful for compliance workflows where document versions must be managed, or when a customer wants to replace a file by first deleting the existing one. It supports a broad range of document types including personal identity documents, business registration files, tax forms, and financial statements.

Request Body

Accepted fileType values:

{
  "fileType": "DriverLicense"
}

Response

200 OK

A successful response indicates the document was found and deleted. No response body is returned.

Error Codes

Common Mistakes

• Providing a fileType string that does not exactly match one of the enum values (values are case-sensitive).
• Attempting to delete a document that was never uploaded — the endpoint returns 404 if no matching document exists for the authenticated user.
• Reusing an expired Bearer token; tokens are valid for 10 minutes and must be refreshed before calling this endpoint.
• Omitting the fileType field entirely from the request body, which results in a 400 validation error.

Related Endpoints

• POST /Files/uploadDocument — Upload a new document of a specified type for the authenticated user
• GET /Files/getDocument — Retrieve a previously uploaded document by file type
• GET /Files/listDocuments — List all documents currently associated with the authenticated user

Example

curl -X POST https://api.banking.netevia.dev/Files/deleteDocument \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileType": "DriverLicense"
  }'