Index: trunk/Nebulous-Server/lib/Nebulous/Server.pod
===================================================================
--- trunk/Nebulous-Server/lib/Nebulous/Server.pod	(revision 20091)
+++ trunk/Nebulous-Server/lib/Nebulous/Server.pod	(revision 20092)
@@ -16,4 +16,5 @@
     Nebulous::Server->create_object( $key, $volume );
     Nebulous::Server->rename_object( $key, $newkey );
+    Nebulous::Server->swap_objects( $key1, $key2 );
     Nebulous::Server->replicate_object( $key, $volume );
     Nebulous::Server->lock_object( $key, $type );
@@ -163,4 +164,10 @@
 Accepts 1 parameters, it is mandatory.  Returns Boolean true.  Throws an
 exception on error.
+
+=item * swap_objects( $key1, $key2 );
+
+Accepts 2 parameters, all mandatory.  Atomically swaps the object names of
+C<$key1> and C<$key2>.  Both objects must already exist.  Return true on
+success or an exception on error.
 
 =item * stat_object( $key );