POST account/update_profile_image
post-account-update_profile_image

POST account/update_profile_image

Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL to an image.

This method asynchronously processes the uploaded file before updating the user's profile image URL. You can either update your local cache the next time you request the user's information, or, at least 5 seconds after uploading the image, ask for the updated URL using GET users / show.

Resource URL

https://api.x.com/1.1/account/update_profile_image.json

Resource Information

Response formats JSON
Requires authentication? Yes (user context only)
Rate limited? Yes

Parameters

Name Required Description Default Value Example
image required The avatar image for the profile, base64-encoded. Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 400 pixels will be scaled down. Animated GIFs will be converted to a static GIF of the first frame, removing the animation.
include_entities optional The entities node will not be included when set to false . false
skip_status optional When set to either true , t or 1 statuses will not be included in the returned user objects.

Example Request

POST https://api.x.com/1.1/account/update_profile_image.json?image=ABCDEFGH...

Example Response

{
    "contributors_enabled": false, 
    "created_at": "Thu Aug 23 19:45:07 +0000 2012", 
    "default_profile": false, 
    "default_profile_image": false, 
    "description": "Keep calm and test", 
    "favourites_count": 0, 
    "follow_request_sent": false, 
    "followers_count": 0, 
    "following": false, 
    "friends_count": 10, 
    "geo_enabled": true, 
    "id": 776627022, 
    "id_str": "776627022", 
    "is_translator": false, 
    "lang": "en", 
    "listed_count": 0, 
    "location": "San Francisco, CA", 
    "name": "Sean Test", 
    "notifications": false, 
    "profile_background_color": "000000", 
    "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", 
    "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", 
    "profile_background_tile": true, 
    "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", 
    "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", 
    "profile_link_color": "000000", 
    "profile_sidebar_border_color": "000000", 
    "profile_sidebar_fill_color": "000000", 
    "profile_text_color": "000000", 
    "profile_use_background_image": false, 
    "protected": false, 
    "screen_name": "s0c1alm3dia", 
    "show_all_inline_media": false, 
    "statuses_count": 0, 
    "time_zone": "Pacific Time (US & Canada)", 
    "url": "http://twitter.com", 
    "utc_offset": -28800, 
    "verified": false
}