Delete a Corpus

DELETE

/api/v2/corpora/{corpus_id}

Allows authorized users to permanently delete a specific corpus using its unique identifier (corpus_id).
This action removes all associated metadata and document references from the system.

Purpose:

Intended for cases where a corpus is no longer needed, outdated, or created by mistake.

Path Parameters:

corpus_id (int): The ID of the corpus to delete

Returns:

A response with the success message

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

If the user does not have permission to delete the corpus, the endpoint will return a 403 error

Response Headers:

X-Authorization-Consistency-Token (string): Authorization consistency token returned after a write operation. Pass this in subsequent read requests to ensure read-after-write consistency.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Success

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE 'https:///api/v2/corpora/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {}
}

Update a Corpus

Get Corpus Agent Connections