Statuses/update
« Return to the list of API methods
Contents |
URL
http://yourserver/api/statuses/update.format
Description
Updates the status of the authentificated user.
Required and optional parameters can be sent through GET or POST, but the Request method has to be POST.
Available formats
XML, JSON
HTTP Method
POST
Requires authentication
YES
Required parameters
- status: The content of the status you are going to post. It should be URL encoded
Optional parameters
- in_reply_to: The ID of the note you want to reply to. Example: http://yourserver/api/statuses/update.json?update=Abc&in_reply_to=123
Return example (XML)
curl http://yourserver/api/statuses/update.xml?status=abcdefg -d ""
<?xml version="1.0" encoding="UTF-8"?> <status> <id>34</id> <created_at>Thu Apr 22 18:02:58 +0000 2010</created_at> <text>abcdefg</text> <source>api</source> <truncated>false</truncated> <in_reply_to_status_id/> <in_reply_to_user_id/> <favorited>false</favorited> <in_reply_to_screen_name/> <user> <id>1</id> <name>marcosgdf</name> <screen_name>marcosgdf</screen_name> <location/> <description/> <profile_image_url>http://localhost/trunk/static/img/avatar/default_note.png</profile_image_url> <url/> <protected>true</protected> <followers_count>0</followers_count> <created_at>Fri Apr 16 20:12:11 +0000 2010</created_at> <favourites_count>0</favourites_count> <statuses_count>6</statuses_count> <friends_count>0</friends_count> <following>false</following> <utc_offset/> <geo_enabled>false</geo_enabled> <time_zone/> <profile_background_image_url>http://localhost/trunk/themes/transparency/img/bg.png</profile_background_image_url> <profile_background_tile>false</profile_background_tile> <notifications>false</notifications> <verified>false</verified> <lang>default</lang> <contributors_enabled>false</contributors_enabled> </user> </status>
Return example (JSON)
curl http://yourserver/api/statuses/update.json?status=abcdefg -d ""
{ "id": 35, "created_at": "Thu Apr 22 18:04:12 +0000 2010", "text": "abcdefg", "source": "api", "truncated": false, "in_reply_to_status_id": null, "in_reply_to_user_id": null, "in_reply_to_screen_name": null, "geo": null, "favorited": false, "contributors": null, "coordinates": null, "user": { "id": 1, "name": "marcosgdf", "screen_name": "marcosgdf", "location": null, "description": "", "profile_image_url": "http:\/\/localhost\/trunk\/static\/img\/avatar\/default_note.png", "url": null, "protected": true, "followers_count": "0", "created_at": "Fri Apr 16 20:12:11 +0000 2010", "favourites_count": 0, "statuses_count": "7", "friends_count": "0", "following": false, "utc_offset": null, "time_zone": null, "profile_background_image_url": "http:\/\/localhost\/trunk\/themes\/transparency\/img\/bg.png", "profile_background_tile": false, "notifications": false, "verified": false, "lang": "default", "contributions_enabled": false, "geo_enabled": false } }

