POST account/update_profile_background_image

Updates the authenticating user’s profile background image. This method can also be used to enable or disable the profile background image.

Although each parameter is marked as optional, at least one of image or media_id must be provided when making this request.

Resource URL

https://api.twitter.com/1.1/account/update_profile_background_image.json

Resource Information

Response formats JSON
Requires authentication? Yes
Rate limited? Yes

Parameters

Name Required Description Default Value Example
image optional The background image for the profile, base64-encoded. Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forcibly scaled down. The image must be provided as raw multipart data, not a URL.    
tile optional Whether or not to tile the background image. If set to true , t or 1 the background image will be displayed tiled. The image will not be tiled otherwise.    
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.    
media_id optional Specify the media to use as the background image. More information on upload of media is available here .    

Example Request

POST https://api.twitter.com/1.1/account/update_profile_background_image.json?skip_status=1&tile=1&media_id=1656234633

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": "9AE4E8",
    "profile_background_image_url": "http://a0.twimg.com/images/themes/theme16/bg.gif",
    "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme16/bg.gif",
    "profile_background_tile": false,
    "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": "0084B4",
    "profile_sidebar_border_color": "BDDCAD",
    "profile_sidebar_fill_color": "DDFFCC",
    "profile_text_color": "333333",
    "profile_use_background_image": true,
    "protected": false,
    "screen_name": "s0c1alm3dia",
    "show_all_inline_media": false,
    "statuses_count": 0,
    "time_zone": "Pacific Time (US & Canada)",
    "url": "http://cnn.com",
    "utc_offset": -28800,
    "verified": false
}