Skip to main content

Delete Dataset

Delete a dataset permanently.

Endpoint​

DELETE https://api.platform.knowledgator.com/datasets/{dataset_id}/


Headers​

NameTypeDescription
KnowledgatorAPI-KeyStringYour API key

Request Parameters​

ParameterTypeRequiredDescription
dataset_idStringYes (path)Dataset identifier (2-64 chars, alphanumeric with hyphens)

Response​

Returns 204 No Content on success.


Error Codes​

Status CodeDescription
204No Content – Delete successful.
400Bad Request – Invalid dataset_id or dataset doesn't exist.
401Unauthorized – Invalid API key or email verification required.
403Forbidden – Invalid CSRF token.
500Internal 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