---
title: "Delete a file from the Playground"
method: DELETE
path: "/api/playground"
tags: ["Playground"]
---

# Delete a file from the Playground

`DELETE /api/playground`

Deletes the specified file from the Playground folder. Returns 200 with
`task_id` if a server restart is needed, or 204 if not.
Requires `admin`, `developer`, or the `playground_control` permission.

## Query parameters

- `filename` string, required
- `folder` 'questions' | 'sources' | 'static' | 'templates' | 'modules'
- `project` string
- `user_id` integer
- `restart` 0 | 1

## Response `200`

File deleted; server restart initiated.

- TaskId
  - `task_id` string, required — Opaque identifier that can be passed to a status endpoint.

## Other responses

- `204` — File deleted; no restart needed.
- `400` — Bad request.
- `403` — Access denied.

---

[API](https://skmtc.dev/docassemble/apis/docassemble-api.md) · [All operations](https://skmtc.dev/docassemble/apis/docassemble-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docassemble/docassemble-api/revisions/a75d7eea6826/schema)