.. include:: common.rst Statuses ======== .. http:post:: /api/statuses/update.json Post a new status. :form status: the text of your status update :form source: (optional) the name of application you update the status from :form in_reply_to_status_id: (optional) the ID of an existing status that the update is in reply to :form lat: (optional) the latitude of the location this status refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn’t a corresponding ``long`` parameter :form long: (optional) the longitude of the location this status refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number or if there not a corresponding ``lat`` parameter :form media: (optional) |image| :reqheader Authorization: |auth| **Example response**: :ref:`status_object` .. http:post:: /api/statuses/destroy/(int:status_id).json Delete the status specified by the required ID parameter. The authenticating user must be the author of the specified status. The destroyed status if successful is returned. :param int status_id: the ID of the status to delete :reqheader Authorization: |auth| **Example response**: :ref:`status_object` .. http:get:: /api/statuses/show/(int:status_id).json Show a specified status. :param int status_id: the ID of the status to show **Example response**: :ref:`status_object` .. http:post:: /api/statuses/retweet/(int:status_id).json Repeat a status. :param int status_id: the ID of the status to repeat :reqheader Authorization: |auth| **Example response**: :ref:`status_object` .. http:get:: /api/statuses/conversation/(int:conversation_id).json Show statuses that have been posted in the conversation. :param int conversation_id: the ID of the conversation to show :query int count: |status_count| :query int since_id: |status_since_id| :query int max_id: |status_max_id| **Example response**: a list of :ref:`status objects `