Delete Dataset
Delete a dataset permanently.
Endpoint
DELETE https://api.platform.knowledgator.com/datasets/{dataset_id}/
Headers
| Name | Type | Description |
|---|---|---|
KnowledgatorAPI-Key | String | Your API key |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
dataset_id | String | Yes (path) | Dataset identifier (2-64 chars, alphanumeric with hyphens) |
Response
Returns 204 No Content on success.
Error Codes
| Status Code | Description |
|---|---|
| 204 | No Content – Delete successful. |
| 400 | Bad Request – Invalid dataset_id or dataset doesn't exist. |
| 401 | Unauthorized – Invalid API key or email verification required. |
| 403 | Forbidden – Invalid CSRF token. |
| 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.delete('6babd48a-2256-4466-b16b-9fd45ba59688');
console.log('Dataset deleted successfully');
Python
from knowledgator import Knowledgator
kg = Knowledgator(api_key="YOUR_API_KEY")
kg.datasets.delete("6babd48a-2256-4466-b16b-9fd45ba59688")
print("Dataset deleted successfully")
Expected SDK Output
Dataset deleted successfully
Python
import requests
url = "https://api.platform.knowledgator.com/datasets/6babd48a-2256-4466-b16b-9fd45ba59688/"
headers = {
"KnowledgatorAPI-Key": "YOUR_API_KEY"
}
response = requests.delete(url, headers=headers)
print(f"Status: {response.status_code}")
cURL
curl -i -X DELETE "https://api.platform.knowledgator.com/datasets/6babd48a-2256-4466-b16b-9fd45ba59688/" \
-H "KnowledgatorAPI-Key: YOUR_API_KEY"
Expected Response (cURL)
HTTP/1.1 204 No Content
Additional Information
- Permanent Deletion: This action cannot be undone. All dataset files and metadata will be permanently deleted.
- Confirmation: Consider implementing a confirmation step in your application before deleting datasets
- Use Cases:
- Remove obsolete or test datasets
- Clean up datasets that are no longer needed
- Free up storage space