Syntext DOCS
Docs Agent Get Started
API Delete Project

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.

DELETE/v1/projects/{projectId}

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"
  }
}
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.

Ask me anything about the documentation.

ESC