Delete Raw Data
Permanently remove a raw data item.
Endpoint
DELETE https://api.platform.knowledgator.com/data/{id}/
Headers
| Name | Type | Description |
|---|---|---|
KnowledgatorAPI-Key | String | Your API key |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | String | Yes | Unique data identifier |
Response
{
"status": "success",
"message": "Data deleted successfully"
}
Error Codes
| Status Code | Description |
|---|---|
| 200 | OK – Deletion successful. |
| 401 | Unauthorized – Invalid API key. |
| 404 | Not Found – Invalid data ID. |
| 500 | Internal Server Error – Server-side issue. |
Example Usage
SDK Usage
💡 Dedicated SDK Guides: See Python SDK | TypeScript SDK
TypeScript/JavaScript
import { createClient } from '@knowledgator/typescript-sdk';
const kg = createClient('YOUR_API_KEY');
await kg.datasets.deleteData('data-123');
Python
from knowledgator import Knowledgator
kg = Knowledgator(api_key="YOUR_API_KEY")
kg.datasets.delete_data('data-123')
Python
import requests
data_id = "data-123"
url = f"https://api.platform.knowledgator.com/data/{data_id}/"
headers = {
"KnowledgatorAPI-Key": "YOUR_API_KEY"
}
response = requests.delete(url, headers=headers)
print(response.json())
cURL
curl -X DELETE https://api.platform.knowledgator.com/data/data-123/ \
-H "KnowledgatorAPI-Key: YOUR_API_KEY"
Additional Information
- Permanent Deletion: Once deleted, the record and its associated files cannot be recovered via the API.
- Use Cases:
- Removing obsolete data
- Cleaning up temporary records
- Managing storage limits