From c0c6f166dae360d0d9ec4759928137a2b344ab8f Mon Sep 17 00:00:00 2001 From: Harmon Date: Mon, 26 Aug 2019 23:41:12 -0500 Subject: [PATCH] Update documentation for API.update_status --- docs/api.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/api.rst b/docs/api.rst index dfe60cd..eb4f770 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -130,8 +130,16 @@ Status methods [source], [place_id], [display_coordinates], \ [media_ids]) - Update the authenticated user's status. Statuses that are duplicates or too - long will be silently ignored. + Updates the authenticating user's current status, also known as Tweeting. + + For each update attempt, the update text is compared with the authenticating + user's recent Tweets. Any attempt that would result in duplication will be + blocked, resulting in a 403 error. A user cannot submit the same status + twice in a row. + + While not rate limited by the API, a user is limited in the number of Tweets + they can create at a time. If the number of updates posted by the user + reaches the current allowed limit this method will return an HTTP 403 error. :param status: The text of your status update. :param in_reply_to_status_id: The ID of an existing status that the update -- 2.25.1