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
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
Consensus request deleted successfully
Invalid or missing API key
Consensus request with the specified ID was not found or was already deleted
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
- Irreversible Action: Deleted consensus requests cannot be recovered
- Results Loss: Any consensus results will be permanently lost
- Billing: You may still be charged for processing time even if you delete the request
- Rate Limiting: Deletion does not affect your rate limiting quotas
