---
title: "Create, delete, or list outreach lists. action='create' creates a new list; 'delete' removes it; 'list' returns a stable"
method: DELETE
path: "/api/v1/lists/{list_id}"
tags: ["lists"]
---

# Create, delete, or list outreach lists. action='create' creates a new list; 'delete' removes it; 'list' returns a stable

`DELETE /api/v1/lists/{list_id}`

## Request

- Base URL: `https://crispy.sh`
- URL: `https://crispy.sh/api/v1/lists/{list_id}`
- Auth: HTTP bearer

## Path parameters

- `list_id` string, required

## Request body

- object
  - `name` string: Human-readable list name (for action='create')
  - `description` string: Optional list description (for action='create')
  - `kind` 'contacts' | 'companies' | 'blocklist': List kind. Default 'contacts'. 'blocklist' creates a managed do-not-contact roster.
  - `include_archived` boolean: Include archived lists (for action='list', default: false)
  - `limit` number: Max results to return (for action='list', default 50, max 100)
  - `offset` number: Pagination offset (for action='list', default 0)

## Response `200`

Success

## Other responses

- `401`: Missing or expired API key
- `403`: Insufficient key scope or permission denied
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crispy/apis/crispy-rest-api.md) · [All operations](https://skmtc.dev/crispy/apis/crispy-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crispy/apis/crispy-rest-api/revisions/6bed0974d9ce?raw)