DELETE
/
alpha
/
consensus
/
{id}
curl -X DELETE "https://api.sully.ai/alpha/consensus/consensus_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY"

// No response body - successful deletion

​
Overview

Permanently delete a medical consensus request and all associated data. This action cannot be undone.
This action is irreversible. Once a consensus request is deleted, it cannot be recovered. Make sure you have saved any important results before deletion.

​
Path Parameters

​
id
string
required
The unique identifier of the consensus request to delete

​
Response

This endpoint returns no content on successful deletion. 
curl -X DELETE "https://api.sully.ai/alpha/consensus/consensus_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY"

// No response body - successful deletion

​
Status Codes

​
204
No Content
Consensus request deleted successfully
​
401
Unauthorized
Invalid or missing API key
​
404
Not Found
Consensus request with the specified ID was not found or was already deleted
​
500
Internal Server Error
Server error occurred while deleting the request

​
Use Cases

​
Cleanup Completed Requests

Delete old consensus requests that are no longer needed: 
async function cleanupOldRequests() {
  // Get all requests
  const response = await fetch('https://api.sully.ai/alpha/consensus', {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  
  const data = await response.json();
  const oldRequests = data.data.filter(request => {
    const createdDate = new Date(request.createdAt);
    const thirtyDaysAgo = new Date();
    thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
    
    return createdDate < thirtyDaysAgo && request.status === 'completed';
  });

  // Delete old requests
  for (const request of oldRequests) {
    await fetch(`https://api.sully.ai/alpha/consensus/${request.id}`, {
      method: 'DELETE',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    });
  }
  
  console.log(`Deleted ${oldRequests.length} old requests`);
}

​
Cancel Pending Requests

Remove requests that are no longer needed: 
async function cancelPendingRequest(consensusId) {
  try {
    const response = await fetch(`https://api.sully.ai/alpha/consensus/${consensusId}`, {
      method: 'DELETE',
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    });
    
    if (response.ok) {
      console.log('Pending request cancelled successfully');
    } else {
      console.error('Failed to cancel request');
    }
  } catch (error) {
    console.error('Error cancelling request:', error);
  }
}

​
Important Notes

  1. Irreversible Action: Deleted consensus requests cannot be recovered
  2. Results Loss: Any consensus results will be permanently lost
  3. Billing: You may still be charged for processing time even if you delete the request
  4. Rate Limiting: Deletion does not affect your rate limiting quotas