> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardeck.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Knowledge Item

Soft-deletes a knowledge item. The item can be restored by an admin via the dashboard trash. Requires `knowledge:admin` permission on the key's role.

<ParamField path="path" type="string" required>
  The item path, e.g. `docs/api/overview.md`.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "message": "Knowledge item deleted"
    }
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": "Forbidden — requires knowledge:admin permission"
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Knowledge item not found"
  }
  ```
</ResponseExample>

<ResponseField name="success" type="boolean" required>
  Always `true` for successful responses.
</ResponseField>

<ResponseField name="data" type="object" required>
  <Expandable title="data">
    <ResponseField name="message" type="string" required>
      Confirmation message.
    </ResponseField>
  </Expandable>
</ResponseField>