Skip to main content
This performs a soft delete operation, marking the object as inactive while preserving data integrity and audit trails.
This action marks the object as deleted but preserves it for audit purposes. The object will no longer appear in normal listings but remains accessible for compliance and audit trail verification.

​
Request

curl -X DELETE "https://api.g2cplatform.com/v2/objects/123e4567-e89b-12d3-a456-426614174000" \
  -H "X-API-Key: YOUR_API_KEY"

​
Path Parameters

ParameterTypeRequiredDescription
objectIdstring (uuid)YesUnique identifier for the object to delete

​
Response

No content - object deleted successfully

​
Response Codes

Status CodeDescription
204Object deleted successfully
401Unauthorized - invalid API key
404Object not found
500Internal server error

​
Usage Notes

  • Soft Delete: Objects are marked as inactive rather than permanently removed
  • Audit Trail: Deletion events are logged for compliance and audit purposes
  • Blockchain Record: Deletion is recorded on the blockchain for immutable proof
  • Data Preservation: Object data is preserved for audit and compliance requirements
  • Access Control: Deleted objects are not returned in normal API queries

​
Best Practices

  1. Verify Before Deletion: Use the Get Object endpoint to confirm the object details before deletion
  2. Document Reasons: Consider updating the object with a deletion reason before deleting
  3. Backup Important Data: Export or backup critical object data before deletion
  4. Inform Stakeholders: Notify relevant users before deleting shared objects
  5. Consider Alternatives: Use status updates instead of deletion if the object might be needed later