PermuteDocs
Go to Permute

Skills · skillsDelete

Delete a skill

Workspace scope. Requires skill write permission. Soft-deletes a shared Markdown file.

DELETE/v1/skills/{path}
betaapiKeyworkspace

When to use

Remove obsolete business context.

For agents

This soft-deletes the shared file in the selected scope.

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.skills.delete('finance/revenue.md');

Response

json
{
  "data": {
    "success": true,
    "message": "Deleted finance/revenue.md"
  }
}