delete
https://api.eliosfund.com/designs/
Permanently removes a specific solar system design from a project.
Business Context: Use this endpoint to delete designs that are no longer needed, were created in error, or when project requirements have changed to eliminate specific design versions.
Common Deletion Scenarios:
- Design Iterations: Removing outdated or superseded design versions
- Error Correction: Deleting designs created with incorrect data
- Project Changes: Removing designs that no longer meet requirements
- Storage Management: Cleaning up unused or duplicate designs
- Workflow Cleanup: Removing draft designs that won't be developed
Important Considerations:
- Permanent Action: Design deletion cannot be undone
- Primary Design Protection: Cannot delete the primary/active design
- Project Impact: Deletion may affect project documentation and history
- Dependencies: Check for related attachments or references before deletion
- Approval Requirements: Some deletions may require manager approval
Business Rules:
- Cannot delete primary designs (must promote another design to primary first)
- Cannot delete designs from finalized or completed projects
- Associated external identifiers and metadata are also removed
- Audit logs maintain record of deletion for compliance
Alternative Actions:
- Consider updating design status instead of deletion for audit trail
- Use design versioning to track evolution rather than deleting old versions
- Mark designs as inactive rather than permanent deletion