Delete a list

Deletes the list softly: it stays readable (deleted_at, and in the list with include_deleted=true) and takes no change from now on; its subscribers are kept. Deleting a deleted list changes nothing. Needs scope write.

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id
`list_id`required	path	string · uuid	The list’s id

Request body

None.

Responses

204

The list is deleted

No content.

401

No valid key

Problem (application/problem+json)

403

A project key without scope write (forbidden)

Problem (application/problem+json)

404

No such project or list in it, or another project’s (not_found)

Problem (application/problem+json)

409

The project is deleted (conflict)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)

bashRequest

# set POSTWIND_URL, POSTWIND_KEY and the ids first
curl -X DELETE "$POSTWIND_URL/api/v1/projects/$PROJECT_ID/lists/$LIST_ID" \
  -H "Authorization: Bearer $POSTWIND_KEY"

MCP tool `delete_list` requires confirm

Call it: when a list is no longer used.
Needs: an admin key with project_id, or a project key with scope write (its own project; the argument is ignored), and confirm: true; without it the call changes nothing and tells what it would do.
Returns: outcome (would_delete, deleted, already_deleted), effect in words and the list as get_list returns it after the call; the API’s DELETE /api/v1/projects/{project_id}/lists/{list_id} answers 204.

jsontools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_list",
    "arguments": {
      "list_id": "<list_id>",
      "confirm": false
    }
  }
}

Open the tool page