From: volnt <florent.esp@gmail.com>
Date: Fri, 19 Sep 2014 09:38:27 +0000 (+0200)
Subject: Update docstrings and methods in api.py.
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=73d942e4c3d2ee6088c8e0720f01b5c44b264584;p=tweepy.git

Update docstrings and methods in api.py.

Update the references URL in the doctring with the new Twitter API doc.
Fix formatting for :allowed_param in the docstring.
Fix method for destroy endpoints (POST instead of DELETE).
---

diff --git a/tweepy/api.py b/tweepy/api.py
index 7d9cbbe..423c23f 100644
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -72,7 +72,7 @@ class API(object):
 
     @property
     def home_timeline(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/home_timeline
             :allowed_param:'since_id', 'max_id', 'count'
         """
         return bind_api(
@@ -89,7 +89,7 @@ class API(object):
 
     @property
     def _statuses_lookup(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.5/get/statuses/lookup
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/lookup
             :allowed_param:'id', 'include_entities', 'trim_user', 'map'
         """
         return bind_api(
@@ -102,7 +102,7 @@ class API(object):
 
     @property
     def user_timeline(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/user_timeline
             :allowed_param:'id', 'user_id', 'screen_name', 'since_id'
         """
         return bind_api(
@@ -115,7 +115,7 @@ class API(object):
 
     @property
     def mentions_timeline(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/mentions_timeline
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/mentions_timeline
             :allowed_param:'since_id', 'max_id', 'count'
         """
         return bind_api(
@@ -141,7 +141,7 @@ class API(object):
 
     @property
     def retweets_of_me(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/retweets_of_me
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/retweets_of_me
             :allowed_param:'since_id', 'max_id', 'count'
         """
         return bind_api(
@@ -154,8 +154,8 @@ class API(object):
 
     @property
     def get_status(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/show
-            :allowed_param:'id
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/show/%3Aid
+            :allowed_param:'id'
         """
         return bind_api(
             api=self,
@@ -167,7 +167,7 @@ class API(object):
 
     @property
     def update_status(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/statuses/update
+        """ :reference: https://dev.twitter.com/rest/reference/post/statuses/update
             :allowed_param:'status', 'in_reply_to_status_id', 'lat', 'long', 'source', 'place_id', 'display_coordinates'
         """
         return bind_api(
@@ -180,7 +180,9 @@ class API(object):
         )
 
     def update_with_media(self, filename, *args, **kwargs):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/statuses/update_with_media """
+        """ :reference: https://dev.twitter.com/rest/reference/post/statuses/update_with_media
+            :allowed_param:'status', 'possibly_sensitive', 'in_reply_to_status_id', 'lat', 'long', 'place_id', 'display_coordinates'
+        """
         f = kwargs.pop('file', None)
         headers, post_data = API._pack_image(filename, 3072, form_field='media[]', f=f)
         kwargs.update({'headers': headers, 'post_data': post_data})
@@ -199,7 +201,7 @@ class API(object):
 
     @property
     def destroy_status(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/statuses/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/statuses/destroy/%3Aid
             :allowed_param:'id'
         """
         return bind_api(
@@ -213,7 +215,7 @@ class API(object):
 
     @property
     def retweet(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/statuses/retweet
+        """ :reference: https://dev.twitter.com/rest/reference/post/statuses/retweet/%3Aid
             :allowed_param:'id'
         """
         return bind_api(
@@ -227,7 +229,7 @@ class API(object):
 
     @property
     def retweets(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/retweets
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/retweets/%3Aid
             :allowed_param:'id', 'count'
         """
         return bind_api(
@@ -240,7 +242,7 @@ class API(object):
 
     @property
     def retweeters(self):
-        """ 
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/retweeters/ids
             :allowed_param:'id', 'cursor', 'stringify_ids
         """
         return bind_api(
@@ -252,8 +254,8 @@ class API(object):
 
     @property
     def get_user(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/show
-            :allowed_param:'id', 'user_id', 'screen_name
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/show
+            :allowed_param:'id', 'user_id', 'screen_name'
         """
         return bind_api(
             api=self,
@@ -264,8 +266,8 @@ class API(object):
 
     @property
     def get_oembed(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/statuses/oembed
-            :allowed_param:'id', 'url', 'maxwidth', 'hide_media', 'omit_script', 'align', 'related', 'lang
+        """ :reference: https://dev.twitter.com/rest/reference/get/statuses/oembed
+            :allowed_param:'id', 'url', 'maxwidth', 'hide_media', 'omit_script', 'align', 'related', 'lang'
         """
         return bind_api(
             api=self,
@@ -280,8 +282,8 @@ class API(object):
 
     @property
     def _lookup_users(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/lookup.json
-            allowed_param=['user_id', 'screen_name'],
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/lookup
+            allowed_param='user_id', 'screen_name'
         """
         return bind_api(
             api=self,
@@ -296,7 +298,7 @@ class API(object):
 
     @property
     def search_users(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/search
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/search
             :allowed_param:'q', 'count', 'page'
         """
         return bind_api(
@@ -309,8 +311,8 @@ class API(object):
 
     @property
     def suggested_users(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/suggestions/%3slug
-            :allowed_param:'slug', 'lang
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/suggestions/%3Aslug
+            :allowed_param:'slug', 'lang'
         """
         return bind_api(
             api=self,
@@ -322,7 +324,7 @@ class API(object):
 
     @property
     def suggested_categories(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/suggestions
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/suggestions
             :allowed_param:'lang'
         """
         return bind_api(
@@ -335,7 +337,7 @@ class API(object):
 
     @property
     def suggested_users_tweets(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/users/suggestions/%3slug/members
+        """ :reference: https://dev.twitter.com/rest/reference/get/users/suggestions/%3Aslug/members
             :allowed_param:'slug'
         """
         return bind_api(
@@ -348,7 +350,7 @@ class API(object):
 
     @property
     def direct_messages(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/direct_messages
+        """ :reference: https://dev.twitter.com/rest/reference/get/direct_messages
             :allowed_param:'since_id', 'max_id', 'count'
         """
         return bind_api(
@@ -361,7 +363,7 @@ class API(object):
 
     @property
     def get_direct_message(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/direct_messages/show
+        """ :reference: https://dev.twitter.com/rest/reference/get/direct_messages/show
             :allowed_param:'id'
         """
         return bind_api(
@@ -374,7 +376,7 @@ class API(object):
 
     @property
     def sent_direct_messages(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/direct_messages/sent
+        """ :reference: https://dev.twitter.com/rest/reference/get/direct_messages/sent
             :allowed_param:'since_id', 'max_id', 'count', 'page'
         """
         return bind_api(
@@ -387,7 +389,7 @@ class API(object):
 
     @property
     def send_direct_message(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/direct_messages/new
+        """ :reference: https://dev.twitter.com/rest/reference/post/direct_messages/new
             :allowed_param:'user', 'screen_name', 'user_id', 'text'
         """
         return bind_api(
@@ -401,13 +403,13 @@ class API(object):
 
     @property
     def destroy_direct_message(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/delete/direct_messages/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/direct_messages/destroy
             :allowed_param:'id'
         """
         return bind_api(
             api=self,
             path='/direct_messages/destroy.json',
-            method='DELETE',
+            method='POST',
             payload_type='direct_message',
             allowed_param=['id'],
             require_auth=True
@@ -415,7 +417,7 @@ class API(object):
 
     @property
     def create_friendship(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/friendships/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/friendships/create
             :allowed_param:'id', 'user_id', 'screen_name', 'follow'
         """
         return bind_api(
@@ -429,13 +431,13 @@ class API(object):
 
     @property
     def destroy_friendship(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/delete/friendships/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/friendships/destroy
             :allowed_param:'id', 'user_id', 'screen_name'
         """
         return bind_api(
             api=self,
             path='/friendships/destroy.json',
-            method='DELETE',
+            method='POST',
             payload_type='user',
             allowed_param=['id', 'user_id', 'screen_name'],
             require_auth=True
@@ -443,8 +445,8 @@ class API(object):
 
     @property
     def show_friendship(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friendships/show
-            :allowed_param:'source_id', 'source_screen_name',
+        """ :reference: https://dev.twitter.com/rest/reference/get/friendships/show
+            :allowed_param:'source_id', 'source_screen_name'
         """
         return bind_api(
             api=self,
@@ -460,7 +462,7 @@ class API(object):
 
     @property
     def _lookup_friendships(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friendships/lookup
+        """ :reference: https://dev.twitter.com/rest/reference/get/friendships/lookup
             :allowed_param:'user_id', 'screen_name'
         """
         return bind_api(
@@ -473,8 +475,8 @@ class API(object):
 
     @property
     def friends_ids(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friends/ids
-            :allowed_param:'id', 'user_id', 'screen_name', 'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/friends/ids
+            :allowed_param:'id', 'user_id', 'screen_name', 'cursor'
         """
         return bind_api(
             api=self,
@@ -485,8 +487,8 @@ class API(object):
 
     @property
     def friends(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friends/list
-            :allowed_param:'id', 'user_id', 'screen_name', 'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/friends/list
+            :allowed_param:'id', 'user_id', 'screen_name', 'cursor'
         """
         return bind_api(
             api=self,
@@ -497,8 +499,8 @@ class API(object):
 
     @property
     def friendships_incoming(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friendships/incoming
-            :allowed_param:'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/friendships/incoming
+            :allowed_param:'cursor'
         """
         return bind_api(
             api=self,
@@ -509,8 +511,8 @@ class API(object):
 
     @property
     def friendships_outgoing(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/friendships/outgoing
-            :allowed_param:'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/friendships/outgoing
+            :allowed_param:'cursor'
         """
         return bind_api(
             api=self,
@@ -521,8 +523,8 @@ class API(object):
 
     @property
     def followers_ids(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/followers/ids
-            :allowed_param:'id', 'user_id', 'screen_name', 'cursor', 'count
+        """ :reference: https://dev.twitter.com/rest/reference/get/followers/ids
+            :allowed_param:'id', 'user_id', 'screen_name', 'cursor', 'count'
         """
         return bind_api(
             api=self,
@@ -533,7 +535,7 @@ class API(object):
 
     @property
     def followers(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/followers/list
+        """ :reference: https://dev.twitter.com/rest/reference/get/followers/list
             :allowed_param:'id', 'user_id', 'screen_name', 'cursor', 'count', 'skip_status', 'include_user_entities'
         """
         return bind_api(
@@ -545,7 +547,9 @@ class API(object):
         )
 
     def verify_credentials(self, **kargs):
-        """ account/verify_credentials """
+        """ :reference: https://dev.twitter.com/rest/reference/get/account/verify_credentials
+            :allowed_param:'include_entities', 'skip_status'
+        """
         try:
             return bind_api(
                 api=self,
@@ -561,7 +565,7 @@ class API(object):
 
     @property
     def rate_limit_status(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/account/rate_limit_status
+        """ :reference: https://dev.twitter.com/rest/reference/get/application/rate_limit_status
             :allowed_param:'resources'
         """
         return bind_api(
@@ -574,7 +578,7 @@ class API(object):
 
     @property
     def set_delivery_device(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_delivery_device
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_delivery_device
             :allowed_param:'device'
         """
         return bind_api(
@@ -588,8 +592,8 @@ class API(object):
 
     @property
     def update_profile_colors(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_profile_colors
-            :allowed_param:'profile_background_color', 'profile_text_color', 'profile_link_color', 'profile_sidebar_fill_color', 'profile_sidebar_border_color'],
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_profile_colors
+            :allowed_param:'profile_background_color', 'profile_text_color', 'profile_link_color', 'profile_sidebar_fill_color', 'profile_sidebar_border_color'
         """
         return bind_api(
             api=self,
@@ -603,7 +607,9 @@ class API(object):
         )
 
     def update_profile_image(self, filename, file_=None):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_profile_image """
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_profile_image
+            :allowed_param:'include_entities', 'skip_status'
+        """
         headers, post_data = API._pack_image(filename, 700, f=file_)
         return bind_api(
             api=self,
@@ -615,7 +621,9 @@ class API(object):
         )(self, post_data=post_data, headers=headers)
 
     def update_profile_background_image(self, filename, **kargs):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_profile_background_image """
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_profile_background_image
+            :allowed_param:'tile', 'include_entities', 'skip_status', 'use'
+        """
         f = kargs.pop('file', None)
         headers, post_data = API._pack_image(filename, 800, f=f)
         bind_api(
@@ -628,7 +636,9 @@ class API(object):
         )(self, post_data=post_data, headers=headers)
 
     def update_profile_banner(self, filename, **kargs):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_profile_banner """
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_profile_banner
+            :allowed_param:'width', 'height', 'offset_left', 'offset_right'
+        """
         f = kargs.pop('file', None)
         headers, post_data = API._pack_image(filename, 700, form_field="banner", f=f)
         bind_api(
@@ -641,7 +651,7 @@ class API(object):
 
     @property
     def update_profile(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/account/update_profile
+        """ :reference: https://dev.twitter.com/rest/reference/post/account/update_profile
             :allowed_param:'name', 'url', 'location', 'description'
         """
         return bind_api(
@@ -655,8 +665,8 @@ class API(object):
 
     @property
     def favorites(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/favorites
-            :allowed_param:'screen_name', 'user_id', 'max_id', 'count', 'since_id', 'max_id
+        """ :reference: https://dev.twitter.com/rest/reference/get/favorites/list
+            :allowed_param:'screen_name', 'user_id', 'max_id', 'count', 'since_id', 'max_id'
         """
         return bind_api(
             api=self,
@@ -667,7 +677,7 @@ class API(object):
 
     @property
     def create_favorite(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/favorites/create
+        """ :reference:https://dev.twitter.com/rest/reference/post/favorites/create
             :allowed_param:'id'
         """
         return bind_api(
@@ -681,7 +691,7 @@ class API(object):
 
     @property
     def destroy_favorite(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/favorites/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/favorites/destroy
             :allowed_param:'id'
         """
         return bind_api(
@@ -695,7 +705,7 @@ class API(object):
 
     @property
     def create_block(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/blocks/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/blocks/create
             :allowed_param:'id', 'user_id', 'screen_name'
         """
         return bind_api(
@@ -709,13 +719,13 @@ class API(object):
 
     @property
     def destroy_block(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/delete/blocks/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/blocks/destroy
             :allowed_param:'id', 'user_id', 'screen_name'
         """
         return bind_api(
             api=self,
             path='/blocks/destroy.json',
-            method='DELETE',
+            method='POST',
             payload_type='user',
             allowed_param=['id', 'user_id', 'screen_name'],
             require_auth=True
@@ -723,7 +733,7 @@ class API(object):
 
     @property
     def blocks(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/blocks/blocking
+        """ :reference: https://dev.twitter.com/rest/reference/get/blocks/list
             :allowed_param:'cursor'
         """
         return bind_api(
@@ -736,7 +746,7 @@ class API(object):
 
     @property
     def blocks_ids(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/blocks/ids """
+        """ :reference: https://dev.twitter.com/rest/reference/get/blocks/ids """
         return bind_api(
             api=self,
             path='/blocks/ids.json',
@@ -746,7 +756,7 @@ class API(object):
 
     @property
     def report_spam(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/report_spam
+        """ :reference: https://dev.twitter.com/rest/reference/post/users/report_spam
             :allowed_param:'user_id', 'screen_name'
         """
         return bind_api(
@@ -760,7 +770,7 @@ class API(object):
 
     @property
     def saved_searches(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/%3Aid """
+        """ :reference: https://dev.twitter.com/rest/reference/get/saved_searches/show/%3Aid """
         return bind_api(
             api=self,
             path='/saved_searches/list.json',
@@ -770,7 +780,7 @@ class API(object):
 
     @property
     def get_saved_search(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/%3Aid
+        """ :reference: https://dev.twitter.com/rest/reference/get/saved_searches/show/%3Aid
             :allowed_param:'id'
         """
         return bind_api(
@@ -783,7 +793,7 @@ class API(object):
 
     @property
     def create_saved_search(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/saved_searches/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/saved_searches/create
             :allowed_param:'query'
         """
         return bind_api(
@@ -797,7 +807,7 @@ class API(object):
 
     @property
     def destroy_saved_search(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/saved_searches/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/saved_searches/destroy/%3Aid
             :allowed_param:'id'
         """
         return bind_api(
@@ -811,7 +821,7 @@ class API(object):
 
     @property
     def create_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/create
             :allowed_param:'name', 'mode', 'description'
         """
         return bind_api(
@@ -825,7 +835,7 @@ class API(object):
 
     @property
     def destroy_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/destroy
             :allowed_param:'owner_screen_name', 'owner_id', 'list_id', 'slug'
         """
         return bind_api(
@@ -839,7 +849,7 @@ class API(object):
 
     @property
     def update_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/update
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/update
             :allowed_param: list_id', 'slug', 'name', 'mode', 'description', 'owner_screen_name', 'owner_id'
         """
         return bind_api(
@@ -853,7 +863,7 @@ class API(object):
 
     @property
     def lists_all(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/list
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/list
             :allowed_param:'screen_name', 'user_id'
         """
         return bind_api(
@@ -866,7 +876,7 @@ class API(object):
 
     @property
     def lists_memberships(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/memberships
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/memberships
             :allowed_param:'screen_name', 'user_id', 'filter_to_owned_lists', 'cursor'
         """
         return bind_api(
@@ -879,7 +889,7 @@ class API(object):
 
     @property
     def lists_subscriptions(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/subscriptions
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/subscriptions
             :allowed_param:'screen_name', 'user_id', 'cursor'
         """
         return bind_api(
@@ -892,8 +902,8 @@ class API(object):
 
     @property
     def list_timeline(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/statuses
-            :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id', 'since_id', 'max_id', 'count', 'include_rts
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/statuses
+            :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id', 'since_id', 'max_id', 'count', 'include_rts'
         """
         return bind_api(
             api=self,
@@ -904,8 +914,8 @@ class API(object):
 
     @property
     def get_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/show
-            :allowed_param:'owner_screen_name', 'owner_id', 'slug', 'list_id
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/show
+            :allowed_param:'owner_screen_name', 'owner_id', 'slug', 'list_id'
         """
         return bind_api(
             api=self,
@@ -916,7 +926,7 @@ class API(object):
 
     @property
     def add_list_member(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/members/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/members/create
             :allowed_param:'screen_name', 'user_id', 'owner_screen_name', 'owner_id', 'slug', 'list_id'
         """
         return bind_api(
@@ -930,7 +940,7 @@ class API(object):
 
     @property
     def remove_list_member(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/members/destroy
             :allowed_param:'screen_name', 'user_id', 'owner_screen_name', 'owner_id', 'slug', 'list_id'
         """
         return bind_api(
@@ -952,7 +962,7 @@ class API(object):
 
     @property
     def _add_list_members(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/members/create_all
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/members/create_all
             :allowed_param:'screen_name', 'user_id', 'slug', 'lit_id', 'owner_id', 'owner_screen_name'
         """
         return bind_api(
@@ -975,7 +985,7 @@ class API(object):
 
     @property
     def _remove_list_members(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy_all
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/members/destroy_all
             :allowed_param:'screen_name', 'user_id', 'slug', 'lit_id', 'owner_id', 'owner_screen_name'
         """
         return bind_api(
@@ -989,8 +999,8 @@ class API(object):
 
     @property
     def list_members(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/members
-            :allowed_param:'owner_screen_name', 'slug', 'list_id', 'owner_id', 'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/members
+            :allowed_param:'owner_screen_name', 'slug', 'list_id', 'owner_id', 'cursor'
         """
         return bind_api(
             api=self,
@@ -1001,8 +1011,8 @@ class API(object):
 
     @property
     def show_list_member(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/members/show
-            :allowed_param:'list_id', 'slug', 'user_id', 'screen_name', 'owner_screen_name', 'owner_id
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/members/show
+            :allowed_param:'list_id', 'slug', 'user_id', 'screen_name', 'owner_screen_name', 'owner_id'
         """
         return bind_api(
             api=self,
@@ -1013,7 +1023,7 @@ class API(object):
 
     @property
     def subscribe_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/create
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/subscribers/create
             :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id'
         """
         return bind_api(
@@ -1027,7 +1037,7 @@ class API(object):
 
     @property
     def unsubscribe_list(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/destroy
+        """ :reference: https://dev.twitter.com/rest/reference/post/lists/subscribers/destroy
             :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id'
         """
         return bind_api(
@@ -1041,8 +1051,8 @@ class API(object):
 
     @property
     def list_subscribers(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/subscribers
-            :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id', 'cursor
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/subscribers
+            :allowed_param:'owner_screen_name', 'slug', 'owner_id', 'list_id', 'cursor'
         """
         return bind_api(
             api=self,
@@ -1053,8 +1063,8 @@ class API(object):
 
     @property
     def show_list_subscriber(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/lists/subscribers/show
-            :allowed_param:'owner_screen_name', 'slug', 'screen_name', 'owner_id', 'list_id', 'user_id
+        """ :reference: https://dev.twitter.com/rest/reference/get/lists/subscribers/show
+            :allowed_param:'owner_screen_name', 'slug', 'screen_name', 'owner_id', 'list_id', 'user_id'
         """
         return bind_api(
             api=self,
@@ -1065,7 +1075,7 @@ class API(object):
 
     @property
     def trends_available(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/trends/available """
+        """ :reference: https://dev.twitter.com/rest/reference/get/trends/available """
         return bind_api(
             api=self,
             path='/trends/available.json',
@@ -1074,8 +1084,8 @@ class API(object):
 
     @property
     def trends_place(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/trends/place
-            :allowed_param:'id', 'exclude
+        """ :reference: https://dev.twitter.com/rest/reference/get/trends/place
+            :allowed_param:'id', 'exclude'
         """
         return bind_api(
             api=self,
@@ -1086,8 +1096,8 @@ class API(object):
 
     @property
     def trends_closest(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/trends/closest
-            :allowed_param:'lat', 'long
+        """ :reference: https://dev.twitter.com/rest/reference/get/trends/closest
+            :allowed_param:'lat', 'long'
         """
         return bind_api(
             api=self,
@@ -1098,8 +1108,8 @@ class API(object):
 
     @property
     def search(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/search
-            :allowed_param:'q', 'lang', 'locale', 'since_id', 'geocode', 'max_id', 'since', 'until', 'result_type', 'count', 'include_entities', 'from', 'to', 'source']
+        """ :reference: https://dev.twitter.com/rest/reference/get/search/tweets
+            :allowed_param:'q', 'lang', 'locale', 'since_id', 'geocode', 'max_id', 'since', 'until', 'result_type', 'count', 'include_entities', 'from', 'to', 'source'
         """
         return bind_api(
             api=self,
@@ -1112,7 +1122,7 @@ class API(object):
     @property
     def trends_daily(self):
         """ :reference: https://dev.twitter.com/docs/api/1.1/get/trends/daily
-            :allowed_param:'date', 'exclude
+            :allowed_param:'date', 'exclude'
         """
         return bind_api(
             api=self,
@@ -1124,7 +1134,7 @@ class API(object):
     @property
     def trends_weekly(self):
         """ :reference: https://dev.twitter.com/docs/api/1.1/get/trends/weekly
-            :allowed_param:'date', 'exclude
+            :allowed_param:'date', 'exclude'
         """
         return bind_api(
             api=self,
@@ -1135,8 +1145,8 @@ class API(object):
 
     @property
     def reverse_geocode(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/geo/reverse_geocode
-            :allowed_param:'lat', 'long', 'accuracy', 'granularity', 'max_results
+        """ :reference: https://dev.twitter.com/rest/reference/get/geo/reverse_geocode
+            :allowed_param:'lat', 'long', 'accuracy', 'granularity', 'max_results'
         """
         return bind_api(
             api=self,
@@ -1147,8 +1157,8 @@ class API(object):
 
     @property
     def geo_id(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/geo/id
-            :allowed_param:'id
+        """ :reference: https://dev.twitter.com/rest/reference/get/geo/id/%3Aplace_id
+            :allowed_param:'id'
         """
         return bind_api(
             api=self,
@@ -1159,8 +1169,8 @@ class API(object):
 
     @property
     def geo_search(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/geo/search
-            :allowed_param:'lat', 'long', 'query', 'ip', 'granularity', 'accuracy', 'max_results', 'contained_within
+        """ :reference: https://dev.twitter.com/rest/reference/get/geo/search
+            :allowed_param:'lat', 'long', 'query', 'ip', 'granularity', 'accuracy', 'max_results', 'contained_within'
         """
         return bind_api(
             api=self,
@@ -1171,8 +1181,8 @@ class API(object):
 
     @property
     def geo_similar_places(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/geo/similar_places
-            :allowed_param:'lat', 'long', 'name', 'contained_within
+        """ :reference: https://dev.twitter.com/rest/reference/get/geo/similar_places
+            :allowed_param:'lat', 'long', 'name', 'contained_within'
         """
         return bind_api(
             api=self,
@@ -1183,7 +1193,7 @@ class API(object):
 
     @property
     def supported_languages(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/help/languages """
+        """ :reference: https://dev.twitter.com/rest/reference/get/help/languages """
         return bind_api(
             api=self,
             path='/help/languages.json',
@@ -1193,7 +1203,7 @@ class API(object):
 
     @property
     def configuration(self):
-        """ :reference: https://dev.twitter.com/docs/api/1.1/get/help/configuration """
+        """ :reference: https://dev.twitter.com/rest/reference/get/help/configuration """
         return bind_api(
             api=self,
             path='/help/configuration.json',