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
, tile
or use
must be provided when making this request.
Resource URL
https://api.twitter.com/1.1/account/update_profile_background_image.json
Resource Information
Parameters
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.
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.
The entities
node will not be included when set to false
.
Example Values: false
When set to either true
, t
or 1
statuses will not be included in the returned user objects.
Determines whether to display the profile background image or not. When set to true
, t
or 1
the background image will be displayed if an image is being uploaded with the request, or has been uploaded previously. An error will be returned if you try to use
a background image when one is not being uploaded or does not exist. If this parameter is defined but set to anything other than true
, t
or 1
, the background image will stop being used.
OAuth Signature Generator
Sign in to see a list of your registered applications.
Example Request
POST
https://api.twitter.com/1.1/account/update_profile_background_image.json?use=1&skip_status=1&tile=1
Example Result
{ "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 }