Database.com Metadata API Developer's Guide - Salesforce.com

CRUD-Based CallsrenameMetadata()NamefullNamesTypestring[]DescriptionArray of full names of the components to delete.Limit: 10.You must submit arrays of only one type of component. For example, you could submitan array of 10 custom objects or 10 profiles, but not a mix of both types.ResponseDeleteResult[]renameMetadata()Renames a metadata component in your organization synchronously.SyntaxSaveResult = metadataConnection.renameMetadata(string metadataType, String oldFullname,String newFullname);UsageUse the renameMetadata() call to rename one metadata component in your organization. This call executes synchronously,meaning the call returns only when the operation completes.You can use this call to rename any of the objects that extend Metadata. For more details, see Metadata Components andTypes.VersionAvailable in API version 30.0 and later.PermissionsYour client application must be logged in with the “Modify All Data” permission.Basic Steps for Renaming Metadata ComponentsUse the following process to rename a metadata component:1. Determine the metadata type of the component you want to rename, its current full name, and the new full name. SeeMetadata for more details on the fullName field.2. Invoke the renameMetadata() call. For the first argument, pass in the name of the metadata type. Pass in the old fullname as the second argument and the new full name as the last argument.A SaveResult object is returned that contains information about whether the operation was successful, the name of therenamed component (which is the new name if the renaming was successful), and any errors returned if the operationwasn’t successful.Sample Code—Javapublic void renameCustomObjectSync() {try {SaveResult[] results = metadataConnection.renameMetadata("CustomObject", "MyCustomObject1__c","MyCustomObject1New__c");for (SaveResult r : results) {53