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.",