Check Duplicate Documents in a Corpus

POST

/api/v2/corpora/{corpus_id}/documents/duplicates

Enables authenticated users to check whether any documents in a provided list already exist within a specific corpus.
This is especially useful for preventing redundant uploads and maintaining a clean, organized document repository.

Purpose:

Identifies duplicate documents by comparing the provided list of document names against existing entries in the target corpus.

Helps maintain document integrity and avoid unnecessary storage of repeated files.

Path Parameters:

corpus_id (int): Corpus ID

Request Body:

documents (list): The list of documents to check for duplicates. For example: ["document1.pdf", "document2.pdf"]

Returns

A response containing the duplicate documents and indexed documents

If the corpus is not found, the endpoint will return a 404 error

Current Version:

2.0.0

Request

Authorization

API Key

Add parameter in header

Ocp-Apim-Subscription-Key

Example:

Ocp-Apim-Subscription-Key: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v2/corpora//documents/duplicates' \
--header 'Ocp-Apim-Subscription-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "documents": [
        null
    ]
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Duplicate documents retrieved successfully",
    "data": {
        "duplicate_files": [
            null
        ],
        "indexed_files": [
            null
        ]
    }
}

Delete Document(s) from a Corpus

Get all Permissions for a Corpus