Braintest
DELETE/v1/project/{project_id}

Delete a project

Deletes a project identified by its unique identifier. Use project_id when you need to remove a project and receive the resulting project record. A 200 response returns the deleted project's details.

1 parameter
project_idstringrequired

The project's unique identifier in UUID format.

6 status codes
200Returns the deleted project object, including its identifier, organization, name, timestamps, creator identifier, and settings.
idstringrequired

Unique identifier for the project

org_idstringrequired

Unique id for the organization that the project belongs under

namestringrequired

Name of the project

createdstringoptional

Date of project creation

deleted_atstringoptional

Date of project deletion, or null if the project is still active

user_idstringoptional

Identifies the user who created the project

settingsobjectoptional
400Returned when the request is unacceptable, often because project_id is missing or invalid.
401Returned when no valid API key is provided.
403Returned when the API key does not have permission to delete the project.
429Returned when too many requests reach the API too quickly.
500Returned when an internal API failure occurs.

Error handling

A 400 is returned when project_id is missing or the request is unacceptable. A 401 indicates that no valid API key was provided, while a 403 indicates that the API key lacks permission; a 429 indicates excessive request frequency, and a 500 indicates an internal API failure.