PermuteDocs
Go to Permute

Datasets · datasetsDelete

Delete a dataset

Soft-deletes one file or custom dataset when the key has dataset admin access.

DELETE/v1/datasets/{datasetId}
betaapiKeyworkspace

When to use

Remove one file or custom dataset that should no longer be available.

For agents

Requires dataset admin access. Deletion is destructive from the caller perspective.

Example

typescript
import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.datasets.delete('data_quickbooks123');

Response

json
{
  "data": {
    "id": "data_quickbooks123",
    "deleted": true
  }
}