Manage account settings and profile
POST account/update_profile_background_image (deprecated)¶
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.
Learn more about the deprecation of this endpoint via our <a href=”https://twittercommunity.com/t/upcoming-changes-to-the-developer-platform/104603”>forum post</a>.
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
}