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

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
    }
}