---
title: "Delete survey"
method: DELETE
path: "/surveys/{id}"
tags: ["Surveys"]
---

# Delete survey

`DELETE /surveys/{id}`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/surveys/{id}`
- Auth: HTTP bearer

Deletes or archives a survey depending on its state:

- **Draft surveys** (unpublished) are soft-deleted and will no longer appear in listings
- **Published surveys** (with or without responses) are archived — their data is preserved but they are hidden from default listings

This operation is idempotent: deleting an already-archived survey returns 200 with `action: "archived"`.

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `success` boolean
  - `data` object
    - `action` 'deleted' | 'archived'

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)