---
title: Delete Project
protocol: rest
method: DELETE
endpoint: /v1/projects/{projectId}
description: "Delete a project and all its content"
---

# Delete Project

Permanently delete a project and all associated content, builds, and configurations.

<Endpoint method="DELETE" path="/v1/projects/{projectId}" />

<Warning>
This action is irreversible. All documentation content, build history, and analytics data will be permanently deleted.
</Warning>

## Path Parameters

<ParamField path="projectId" type="string" required>
  The project ID (e.g., `prj_abc123`).
</ParamField>

## Response

Returns an empty response with `204 No Content` on success.

## Example

<CodeGroup>
```bash cURL
curl -X DELETE https://api.syntext.dev/v1/projects/prj_abc123 \
  -H "Authorization: Bearer stx_abc12345_..."
```

```typescript SDK
import { Syntext } from '@syntext/sdk'

const client = new Syntext('stx_abc12345_...')
await client.projects.delete('prj_abc123')
```

```python Python
from syntext import Syntext

client = Syntext("stx_abc12345_...")
client.projects.delete("prj_abc123")
```
</CodeGroup>

### Response

```
HTTP/1.1 204 No Content
```

## Side Effects

Deleting a project will:

- Remove the live documentation site immediately
- Delete all build history and artifacts
- Remove search index entries
- Delete all analytics data
- Release the custom domain (if configured)
- Revoke any project-specific API keys

<Note>
The project slug becomes available for reuse after deletion.
</Note>

## Error Responses

### 404 Not Found

Returned when the project does not exist.

```json
{
  "error": {
    "code": "not_found",
    "message": "Project does not exist"
  }
}
```

### 403 Forbidden

Returned when you don't have permission to delete this project.

```json
{
  "error": {
    "code": "forbidden",
    "message": "You do not have permission to delete this project"
  }
}
```