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