Delete Project

Permanently delete a project and all its sessions

DELETE /api/v1/projects/{projectId}

cURL

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://cloud.specstory.com/api/v1/projects/proj_abc123

200 Success

{
  "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"
  }
}

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

Request

projectId · string · required

The unique identifier of the project to delete

Authorization · string · required

Bearer token for authentication

Response

success · boolean

Indicates if the request was successful

data · object

Show data

deletedProject · object

Show deletedProject

id · string

Project ID

ownerId · string

Owner ID

name · string

Project name

icon · string

Project icon identifier

color · string

Project color theme

createdAt · string

Creation timestamp

updatedAt · string

Last updated timestamp

deletedAt · string

ISO 8601 timestamp of deletion

cURL

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://cloud.specstory.com/api/v1/projects/proj_abc123

200 Success

{
  "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"
  }
}