---
title: "Delete Poll"
method: DELETE
path: "/api/polls/{poll_id}"
tags: ["polls", "polls"]
---

# Delete Poll

`DELETE /api/polls/{poll_id}`

Creator deletes a scheduling poll outright, in ANY state.

Until this existed the only way out of a poll was `reopen` with
{"cancel": true}, and the UI only offered that inside the FINALIZED block.
So an open poll - the state a poll spends nearly all its life in, and the
state of every poll created by mistake - could not be removed at all. It
sat in the channel feed forever (Nancy hit this demoing polls to Mariana,
2026-09-04).

Removes, in one transaction: the scheduled room and its RSVPs (if the poll
had been finalized), the poll_invite card(s) in the channel feed, every
response (via the relationship cascade), and the poll row itself.

## Path parameters

- `poll_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-09-05** `289faeee8089` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/changes/api/polls/:poll_id/delete.md)

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/revisions/be75c0eba493?raw)