Delete Project

Permanently delete a project and all its sessions

DELETE /api/v1/projects/{projectId}

On this page

Request

projectId string · path · required

The unique identifier of the project to delete

Authorization string · header · required

Bearer token for authentication

Response

success boolean

Indicates if the request was successful

data object

data

deletedProject object

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

Request examples

cURL

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

JavaScript

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();

Python

import requests

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

data = response.json()

Response examples

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

403 Forbidden

{
  "success": false,
  "error": "You do not have permission to delete this project"
}

404 Not Found

{
  "success": false,
  "error": "Project not found"
}