statuses/update

Description

Updates the authenticating user's status. Requires the status parameter specified below. Request must be a POST.

URL pattern

/api/statuses/update.:format

Formats (:format)

xml, json

HTTP Method(s)

POST

Requires Authentication

Yes

Parameters:

	status	(Required) The URL-encoded text of the status update.
	source	(Optional) The source of the status.
	in_reply_to_status_id	(Optional) The ID of an existing status that the update is in reply to.
	lat	(Optional) The latitude the status refers to.
	long	(Optional) The longitude the status refers to.
	media	(Optional) a media upload, such as an image or movie file.

See also:

Authentication

API Root

Usage notes

• The URL pattern is relative to the API Root.
• If the source parameter is not supplied the source of the status will default to 'api'.
• The XML response uses GeoRSS to encode the latitude and longitude (see example response below <georss:point>).
• Data uploaded via the media parameter should be multipart/form-data encoded.

Example usage

    curl -u username:password http://example.com/api/statuses/update.xml -d status='Howdy!' -d lat='30.468' -d long='-94.743'
    

Example response

    <?xml version="1.0" encoding="UTF-8"?>
    <status>
      <text>Howdy!</text>
      <truncated>false</truncated>
      <created_at>Tue Mar 30 23:28:05 +0000 2010</created_at>
      <in_reply_to_status_id/>
      <source>api</source>
      <id>26668724</id>
      <in_reply_to_user_id/>
      <in_reply_to_screen_name/>
      <geo xmlns:georss="http://www.georss.org/georss">
        <georss:point>30.468 -94.743</georss:point>
      </geo>
      <favorited>false</favorited>
      <user>
        <id>25803</id>
        <name>Jed Sanders</name>
        <screen_name>jedsanders</screen_name>
        <location>Hoop and Holler, Texas</location>
        <description>I like to think of myself as America's Favorite.</description>
        <profile_image_url>http://avatar.example.com/25803-48-20080924200604.png</profile_image_url>
        <url>http://jedsanders.net</url>
        <protected>false</protected>
        <followers_count>5</followers_count>
        <profile_background_color/>
        <profile_text_color/>
        <profile_link_color/>
        <profile_sidebar_fill_color/>
        <profile_sidebar_border_color/>
        <friends_count>2</friends_count>
        <created_at>Wed Sep 24 20:04:00 +0000 2008</created_at>
        <favourites_count>0</favourites_count>
        <utc_offset>0</utc_offset>
        <time_zone>UTC</time_zone>
        <profile_background_image_url/>
        <profile_background_tile>false</profile_background_tile>
        <statuses_count>70</statuses_count>
        <following>true</following>
        <notifications>true</notifications>
      </user>
    </status>