/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Delete Project

Delete Project

Delete a project and all its content

DELETE/v1/projects/{projectId}Try it
Session token

Delete a project. A deleted project can't be restored.

Note

Requires the admin or owner role and a session JWT. A member gets 403 forbidden with details.requiredRole: "admin".

Warning

This action is irreversible — there is no way to restore a deleted project.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID, a UUID.

Response

Returns 200 with { "data": { "id": "...", "deleted": true } }.

The repository's push webhook is removed as part of the delete. If it can't be removed — your account has no GitHub connection, or GitHub returned an error — the project is still deleted, and the response adds a warnings array of webhook_teardown_pending entries. These have the same shape as on Update Project.

Side Effects

Deleting a project:

•
Stops every API call, build and deploy for the project — they return 404, and its API keys stop working with it
•
Takes its doc site offline: within about five minutes, its {slug}-docs.syntext.dev address and any custom domains show the not-found page
•
Releases its custom domains: they are removed from the project, and each one can be added to another project
•
Removes images stored for a project written in Syntext
•
Removes the repository's push webhook (see above)
•
Keeps build history and analytics rows, which are no longer reachable
Note

Deleting a project frees its {slug}-docs subdomain, so a new project can use the same slug — see Check Subdomain Availability. Its custom domains are freed too: add one to another project and set up its DNS records again. This applies to projects deleted earlier as well.

Error Responses

404 Not Found

Returned when the project does not exist.

json
{
"error": {
"code": "not_found",
"message": "Project not found"
}
}

403 Forbidden

Returned when you are a member of the workspace but not an admin or owner:

json
{
"error": {
"code": "forbidden",
"message": "Only workspace admins can delete projects.",
"details": { "requiredRole": "admin", "currentRole": "member", "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

Without requiredRole/currentRole, the 403 means you are not a member of the organization that owns the project. A session token alone is not enough.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X DELETE https://api.syntext.dev/v1/projects/3f2b8c1e-6a4d-4e9b-9c7a-1d2e3f4a5b6c \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
json
{
"data": { "id": "3f2b8c1e-6a4d-4e9b-9c7a-1d2e3f4a5b6c", "deleted": true }
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext