diff --git a/doc/obex-agent-api.txt b/doc/obex-agent-api.txt
index 2a2edb6..3923da6 100644
--- a/doc/obex-agent-api.txt
+++ b/doc/obex-agent-api.txt
@@ -41,13 +41,15 @@ Methods		void Release()
 			agent, because when this method gets called it has
 			already been unregistered.
 
-		string Authorize(object transfer, string address, string name,
-					string type, int32 length, int32 time)
+		string AuthorizePush(object transfer)
 
 			This method gets called when the service daemon
 			needs to accept/reject a Bluetooth object push request.
+
 			Returns the full path (including the filename) where
-			the object shall be stored.
+			the object shall be stored. The tranfer object will
+			contain a Filename property that contains the default
+			location and name that can be returned.
 
 			Possible errors: org.bluez.obex.Error.Rejected
 			                 org.bluez.obex.Error.Canceled
diff --git a/doc/obex-api.txt b/doc/obex-api.txt
index c59aa0b..5341b1f 100644
--- a/doc/obex-api.txt
+++ b/doc/obex-api.txt
@@ -130,6 +130,11 @@ Properties	string Status [readonly]
 
 			Complete name of the file being received or sent.
 
+			For incoming object push transaction, this will be
+			the proposed default location and name. It can be
+			overwritten by the AuthorizePush agent callback
+			and will be then updated accordingly.
+
 
 Object Push hierarchy
 =====================