Statuses

statuses.update(server_url, status, *, source=None, in_reply_to_status_id=None, lat=None, long=None, media=None, username='', password='', oauth={})

Updates the authenticating user’s current status.

Parameters:
  • server_url (str) – URL of the server
  • status (str) – the text of your status update.
  • source (str) – (optional) the name of application you update the status from.
  • in_reply_to_status_id (int) – (optional) the ID of an existing status that the update is in reply to.
  • lat (int) – (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 (int) – (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) a file like stream of bytes to upload as attachment
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict

Returns:

Status dict

statuses.show(server_url, status_id, *, username='', password='', oauth={})

Returns a specified status.

Parameters:
  • server_url (str) – URL of the server
  • status_id (int) – ID of the status to show
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict

Returns:

Status dict

statuses.destroy(server_url, status_id, *, username='', password='', oauth={})

Deletes the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful.

Parameters:
  • server_url (str) – URL of the server
  • status_id (int) – ID of the status to delete
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict

Returns:

Status dict

statuses.repeat(server_url, status_id, *, username='', password='', oauth={})

Repeats a status. Returns the original status with repeat details embedded.

Parameters:
  • server_url (str) – URL of the server
  • status_id (int) – ID of the status to repeat
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

dict

Returns:

Status dict

statuses.conversation(server_url, conversation_id, *, since_id=None, max_id=None, count=20, username='', password='', oauth={})

Returns statuses that have been posted in the conversation

Parameters:
  • server_url (str) – URL of the server
  • conversation_id (int) – ID of the conversation to show
  • since_id (int) – (optional) returns statuses with an ID greater than (that is, more recent than) the specified ID
  • max_id (int) – (optional) returns statuses with an ID less than (that is, older than) or equal to the specified ID
  • count (int) – (optional) number of statuses to try and retrieve
  • username (str) – (optional) name of the authenticating user
  • password (str) – (optional) password of the authenticating user
  • oauth (dict) – (optional) OAuth dict
Return type:

list

Returns:

a list of status dicts