Statuses¶
-
POST
/api/statuses/update.json
¶ Post a new status.
Form Parameters: - status – the text of your status update
- source – (optional) the name of application you update the status from
- in_reply_to_status_id – (optional) the ID of an existing status that the update is in reply to
- 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 - 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 - media – (optional) image to upload, encoded in multipart/form-data
Request Headers: - Authorization – username and password or OAuth token to authenticate
Example response: Status object
-
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.
Parameters: - status_id (int) – the ID of the status to delete
Request Headers: - Authorization – username and password or OAuth token to authenticate
Example response: Status object
-
GET
/api/statuses/show/
(int: status_id).json
¶ Show a specified status.
Parameters: - status_id (int) – the ID of the status to show
Example response: Status object
-
POST
/api/statuses/retweet/
(int: status_id).json
¶ Repeat a status.
Parameters: - status_id (int) – the ID of the status to repeat
Request Headers: - Authorization – username and password or OAuth token to authenticate
Example response: Status object
-
GET
/api/statuses/conversation/
(int: conversation_id).json
¶ Show statuses that have been posted in the conversation.
Parameters: - conversation_id (int) – the ID of the conversation to show
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
Example response: a list of status objects