Delete Session

Warning

This action cannot be undone. The session and all its content will be permanently deleted.

Request

projectIdstringpathrequired

The unique identifier of the project

sessionIdstringpathrequired

The unique identifier of the session 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/sessions/550e8400-e29b-41d4-a716-446655440000

const response = await fetch(
  'https://cloud.specstory.com/api/v1/projects/proj_abc123/sessions/550e8400-e29b-41d4-a716-446655440000',
  {
    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/sessions/550e8400-e29b-41d4-a716-446655440000',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()

Response Example

{
  "success": true,
  "data": {
    "success": true
  }
}

{
  "success": false,
  "error": "Insufficient permissions to delete this session"
}

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