emptyRecycleBin()

Syntax

EmptyRecycleBinResult[] = connection.emptyRecycleBin(ID[] ids);
                    

Usage

The recycle bin lets you view and restore recently deleted records for 15 days before they are permanently deleted. Your organization can have up to 5,000 records per license in the Recycle Bin at any one time. For example, if your organization has five user licenses, 25,000 records can be stored in the Recycle Bin. If your organization reaches its Recycle Bin limit, Salesforce automatically removes the oldest records, as long as they have been in the recycle bin for at least two hours.

If you know you will be adding a great number of records to the Recycle Bin and you know you won't need to undelete() them, you may wish to remove them before the Salesforce process deletes records. For example, you can use this call if you are loading a large number of records for testing, or if you are doing a large number of create()calls followed by delete() calls.

Rules and Guidelines

When emptying recycle bins, consider the following rules and guidelines:

• The logged in user can delete any record that he or she can query in their recycle bin, or the recycle bins of any subordinates. If the logged in user has Modify All Data permission, he or she can query and delete records from any recycle bin in the organization.
• Available in version 10.0 and later.
• Maximum number of records is 200.
• Do not include the IDs of any records that will be cascade deleted, or an error will occur.
• Once records are deleted using this call, they cannot be undelete()d.
• After records are deleted from the recycle bin using this call, they can be queried using queryAll() for some time. Typically this time is 24 hours, but may be shorter or longer.

Sample Code—Java

public void emptyRecycleBin(String[] ids) {
  try {
    EmptyRecycleBinResult[] emptyRecycleBinResults = 
        connection.emptyRecycleBin(ids);
    for (int i = 0; i < emptyRecycleBinResults.length; i++) {
      EmptyRecycleBinResult emptyRecycleBinResult = 
          emptyRecycleBinResults[i];
      if (emptyRecycleBinResult.isSuccess()) {
        System.out.println("Recycled ID: " + 
            emptyRecycleBinResult.getId());
      } else {
        Error[] errors = emptyRecycleBinResult.getErrors();
        if (errors.length > 0)  {
          System.out.println("Error code: " + 
              errors[0].getStatusCode());
          System.out.println("Error message: " + 
              errors[0].getMessage());
        }
      }
    }
  } catch (ConnectionException ce) {
    ce.printStackTrace();
  }
}

Sample Code—C#

/// Demonstrates how to empty the Recycle Bin 
    
public void EmptyRecycleBinSample()
{
   // Create an array of strings to hold the IDs of the records to delete 
    
   string[] ids = new string[] { "00ID0000FooAAE", "00ID0000BarAAE" };
   
   try
   {
       // Delete the records 
    
       binding.delete(ids);
   
       // Empty the records from the Recycle Bin 
    
       // to prevent the records from being undeleted 
    
       EmptyRecycleBinResult[] emptyRecycleBinResults = binding.emptyRecycleBin(ids);
   
       // Process the results 
    
       foreach (EmptyRecycleBinResult emptyRecycleBinResult in emptyRecycleBinResults)
       {
           // Check whether the operation succeeded or had errors 
    
           if (emptyRecycleBinResult.success)
           {
               // Get the ID of the record that we removed 
    
               string recordID = emptyRecycleBinResult.id;
           }
           else
           {
               // Handle the errors. We just print out the first error 
    
               // for demonstration purposes 
    
               Error[] errors = emptyRecycleBinResult.errors;
   
               if (errors.Length > 0)
               {
                   Console.WriteLine("Error code: " + errors[0].statusCode);
                   Console.WriteLine("Error message: " + errors[0].message);
               }
           }
       }
   }
   catch (SoapException e)
   {
       Console.WriteLine(e.Message);
       Console.WriteLine(e.StackTrace);
       Console.WriteLine(e.InnerException);
   }
}

Arguments

Response

EmptyRecycleBinResult

Faults

InvalidSObjectFault