Syntext DOCS
Get Started
API Delete Project
DELETE/v1/projects/{projectId}

Delete Project

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

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

Path Parameters

The project ID (e.g., prj_abc123).

Response

Returns an empty response with 204 No Content on success.

Example

curl -X DELETE https://api.syntext.dev/v1/projects/prj_abc123 \
-H "Authorization: Bearer stx_abc12345_..."
import { Syntext } from '@syntext/sdk'

const client = new Syntext('stx_abc12345_...')
await client.projects.delete('prj_abc123')
from syntext import Syntext

client = Syntext("stx_abc12345_...")
client.projects.delete("prj_abc123")

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

The project slug becomes available for reuse after deletion.

Error Responses

404 Not Found

Returned when the project does not exist.

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

403 Forbidden

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

{
  "error": {
    "code": "forbidden",
    "message": "You do not have permission to delete this project"
  }
}
Assistant
Responses are generated using AI and may contain mistakes.

Ask me anything about the documentation.

ESC