POST statuses/update_with_media (deprecated)
This endpoint has been DEPRECATED. Please use POST statuses/update for uploading one or more media entities.
Updates the authenticating user’s current status and attaches media for upload. In other words, it creates a Tweet with a picture attached.
Unlike POST statuses/update, this method expects raw multipart data. Your POST request’s Content-Type
should be set to multipart/form-data
with the media[]
parameter.
The Tweet text will be rewritten to include the media URL(s), which will reduce the number of characters allowed in the Tweet text. If the URL(s) cannot be appended without text truncation, the tweet will be rejected and this method will return an HTTP 403 error.
Users are limited to a specific daily media upload limit. Requests to this endpoint will return the following headers with information regarding the user’s current media upload limits:
X-MediaRateLimit-Limit
- Indicates the total pieces of media the current user may upload before the time indicated inX-MediaRateLimit-Reset
.X-MediaRateLimit-Remaining
- The remaining pieces of media the current user may upload before the time indicated inX-MediaRateLimit-Reset
.X-MediaRateLimit-Reset
- A UTC-based timestamp (in seconds) indicating whenX-MediaRateLimit-Remaining
will reset to the value inX-MediaRateLimit-Limit
and the user can resume uploading media.
If the user is over the daily media limit, this method will return an HTTP 403 error. In addition to media upload limits, the user is still limited in the number of statuses they can publish daily. If the user tries to exceed the number of updates allowed, this method will also return an HTTP 403 error, similar to POST statuses/update.
OAuth is handled differently for POST messages. See Uploading Media for more details on this.
Example Request
Note: The OAuth tool does not support multipart requests, so you will not be able to use it to generate an example request to this endpoint. An example request has been included to demonstrate the multipart request format.
POST /1.1/statuses/update_with_media.json HTTP/1.1 Host: api.twitter.com User-Agent: Go http package Content-Length: 15532 Authorization: OAuth oauth_consumer_key="...", oauth_nonce="...", oauth_signature="...", oauth_signature_method="HMAC-SHA1", oauth_timestamp="1347058301", oauth_token="...", oauth_version="1.0" Content-Type: multipart/form-data;boundary=cce6735153bf14e47e999e68bb183e70a1fa7fc89722fc1efdf03a917340 Accept-Encoding: gzip --cce6735153bf14e47e999e68bb183e70a1fa7fc89722fc1efdf03a917340 Content-Disposition: form-data; name="status" Hello 2012-09-07 15:51:41.375247 -0700 PDT! --cce6735153bf14e47e999e68bb183e70a1fa7fc89722fc1efdf03a917340 Content-Type: application/octet-stream Content-Disposition: form-data; name="media[]"; filename="media.png" ... --cce6735153bf14e47e999e68bb183e70a1fa7fc89722fc1efdf03a917340--
{ "contributors": null, "coordinates": null, "created_at": "Fri Sep 07 22:46:18 +0000 2012", "entities": { "hashtags": [], "media": [ { "display_url": "pic.twitter.com/lX5LVZO", "expanded_url": "http://twitter.com/fakekurrik/status/244204973972410368/photo/1", "id": 244204973989187584, "id_str": "244204973989187584", "indices": [ 44, 63 ], "media_url": "http://pbs.twimg.com/media/A2OXIUcCUAAXj9k.png", "media_url_https": "https://pbs.twimg.com/media/A2OXIUcCUAAXj9k.png", "sizes": { "large": { "h": 175, "resize": "fit", "w": 333 }, "medium": { "h": 175, "resize": "fit", "w": 333 }, "small": { "h": 175, "resize": "fit", "w": 333 }, "thumb": { "h": 150, "resize": "crop", "w": 150 } }, "type": "photo", "url": "http://t.co/lX5LVZO" } ], "urls": [], "user_mentions": [] }, "favorited": false, "geo": null, "id": 244204973972410368, "id_str": "244204973972410368", "in_reply_to_screen_name": null, "in_reply_to_status_id": null, "in_reply_to_status_id_str": null, "in_reply_to_user_id": null, "in_reply_to_user_id_str": null, "place": null, "possibly_sensitive": false, "retweet_count": 0, "retweeted": false, "source": "Fakekurrik's Test Application", "text": "Hello 2012-09-07 15:48:27.889593 -0700 PDT! http://t.co/lX5LVZO", "truncated": false, "user": { "contributors_enabled": false, "created_at": "Fri Sep 09 16:13:20 +0000 2011", "default_profile": false, "default_profile_image": false, "description": "I am just a testing account, following me probably won't gain you very much", "entities": { "description": { "urls": [] }, "url": { "urls": [ { "display_url": null, "expanded_url": null, "indices": [ 0, 24 ], "url": "http://blog.roomanna.com" } ] } }, "favourites_count": 1, "follow_request_sent": false, "followers_count": 2, "following": false, "friends_count": 5, "geo_enabled": true, "id": 370773112, "id_str": "370773112", "is_translator": false, "lang": "en", "listed_count": 0, "location": "Trapped in factory", "name": "fakekurrik", "notifications": false, "profile_background_color": "C0DEED", "profile_background_image_url": "http://a0.twimg.com/profile_background_images/616512781/iarz5lvj7lg7zpg3zv8j.jpeg", "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/616512781/iarz5lvj7lg7zpg3zv8j.jpeg", "profile_background_tile": true, "profile_image_url": "http://a0.twimg.com/profile_images/2440719659/x47xdzkguqxr1w1gg5un_normal.png", "profile_image_url_https": "https://si0.twimg.com/profile_images/2440719659/x47xdzkguqxr1w1gg5un_normal.png", "profile_link_color": "0084B4", "profile_sidebar_border_color": "C0DEED", "profile_sidebar_fill_color": "FFFFFF", "profile_text_color": "333333", "profile_use_background_image": true, "protected": true, "screen_name": "fakekurrik", "show_all_inline_media": false, "statuses_count": 546, "time_zone": "Pacific Time (US & Canada)", "url": "http://blog.roomanna.com", "utc_offset": -28800, "verified": false } }
Resource URL
https://api.twitter.com/1.1/statuses/update_with_media.json
Resource Information
Parameters
The text of your status update. URL encode as necessary. t.co link wrapping may affect character counts if the post contains URLs. You must additionally account for the characters_reserved_per_media
per uploaded media, additionally accounting for space characters in between finalized URLs.
Note: Request the GET help / configuration endpoint to get the current characters_reserved_per_media
and max_media_per_upload
values.
Up to max_media_per_upload
files may be specified in the request, each named media[]
. Supported image formats are PNG, JPG and GIF, including animated GIFs of up to 3MB . This data must be either the raw image bytes or encoded as base64.
Note: Request the GET help / configuration endpoint to get the current max_media_per_upload
and photo_size_limit
values.
Set to true
for content which may not be suitable for every audience.
The ID of an existing status that the update is in reply to.
Note: This parameter will be ignored unless the author of the tweet this parameter references is mentioned within the status text. Therefore, you must include @username
, where username
is the author of the referenced tweet, within the update.
The latitude of the location this tweet refers to. This parameter will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn’t a corresponding long
parameter.
Example Values: 37.7821120598956
The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, not a number, geo_enabled
is disabled, or if there not a corresponding lat
parameter.
Example Values: -122.400612831116
A place in the world identified by a Twitter place ID. Place IDs can be retrieved from geo/reverse_geocode.
Example Values: df51dec6f4ee2b2c
Whether or not to put a pin on the exact coordinates a tweet has been sent from.
Example Values: true
OAuth Signature Generator
Sign in to see a list of your registered applications.