ProjectsDelete Project

Projects

Delete Project

Permanently delete a project and all its sessions

Warning

This action cannot be undone. All sessions within the project will be permanently deleted.

Request

projectIdstringpathrequired

The unique identifier of the project to delete

Authorizationstringheaderrequired

Bearer token for authentication

Response

successboolean

Indicates if the request was successful

dataobject

Request Example

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://cloud.specstory.com/api/v1/projects/proj_abc123
const response = await fetch('https://cloud.specstory.com/api/v1/projects/proj_abc123', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
import requests

response = requests.delete(
    'https://cloud.specstory.com/api/v1/projects/proj_abc123',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()

Response Example

{
  "success": true,
  "data": {
    "deletedProject": {
      "id": "proj_abc123",
      "ownerId": "user_def456",
      "name": "My Web App",
      "icon": "Code2",
      "color": "blue",
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    "deletedAt": "2024-01-15T11:00:00.000Z"
  }
}
{
  "success": false,
  "error": "You do not have permission to delete this project"
}
{
  "success": false,
  "error": "Project not found"
}