Updates the authenticating user's current status, also known as Tweeting.
For each update attempt, the update text is compared with the authenticating user's recent Tweets. Any attempt that would result in duplication will be blocked, resulting in a 403 error. A user cannot submit the same status twice in a row.
Agency responsible for issuing driver licenses, motor vehicle titles, license plates and vessel registrations as well as overseeing the Florida Highway Patrol. Crash and traffic safety statistics, link to information on identity theft.
This page and certain other Twitter sites place and read third party cookies on your browser that are used for non-essential purposes including targeting of ads. Through these cookies, Google, LinkedIn and NewsCred collect personal data about you for their own purposes. We're rebuilding the Twitter API from the ground up to better support developers as they help the world connect to the public conversation. Eventually, the Twitter API v2 will fully replace the v1.1 standard, premium, and enterprise APIs.
While not rate limited by the API, a user is limited in the number of Tweets they can create at a time. If the number of updates posted by the user reaches the current allowed limit this method will return an HTTP 403 error.
About Geo
- Any geo-tagging parameters in the update will be ignored if
geo_enabled
for the user is false (this is the default setting for all users, unless the user has enabled geolocation in their settings) - The number of digits after the decimal separator passed to
lat
(up to 8) is tracked so that when thelat
is returned in a status object it will have the same number of digits after the decimal separator. - Use a decimal point as the separator (and not a decimal comma) for the latitude and the longitude - usage of a decimal comma will cause the geo-tagged portion of the status update to be dropped.
- For JSON, the response mostly uses conventions described in GeoJSON. However, the
geo
object coordinates that Twitter renders are reversed from the GeoJSON specification. GeoJSON specifies a longitude then a latitude, whereas Twitter represents it as a latitude then a longitude:'geo': { 'type':'Point', 'coordinates':[37.78217, -122.40062] }
- The
coordinates
object is replacing thegeo
object (no deprecation date has been set for thegeo
object yet) -- the difference is that the coordinates object, in JSON, is now rendered correctly in GeoJSON. - If a
place_id
is passed into the status update, then that place will be attached to the status. If noplace_id
was explicitly provided, butlatitude
andlongitude
are, the API attempts to implicitly provide a place by calling geo/reverse_geocode. - Users have the ability to remove all geotags from all their Tweets en masse via the user settings page. Currently there is no method to remove geotags from individual Tweets.
Resource URL¶
https://api.twitter.com/1.1/statuses/update.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes (user context only) |
Rate limited? | Yes |
Requests / 3-hour window | 300* per user; 300* per app |
Please note - The 300 per 3 hours is a combined limit with the POST statuses/retweet/:id endpoint. You can only post 300 Tweets or Retweets during a 3 hour period.
Parameters¶
Name | Required | Description | Default Value | Example |
---|---|---|---|---|
status | required | The text of the status update. URL encode as necessary. t.co link wrapping will affect character counts. | ||
in_reply_to_status_id | optional | 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. | ||
auto_populate_reply_metadata | optional | If set to true and used with in_reply_to_status_id , leading @mentions will be looked up from the original Tweet, and added to the new Tweet from there. This wil append @mentions into the metadata of an extended Tweet as a reply chain grows, until the limit on @mentions is reached. In cases where the original Tweet has been deleted, the reply will fail. |
|
|
exclude_reply_user_ids | optional | When used with auto_populate_reply_metadata , a comma-separated list of user ids which will be removed from the server-generated @mentions prefix on an extended Tweet. Note that the leading @mention cannot be removed as it would break the in-reply-to-status-id semantics. Attempting to remove it will be silently ignored. |
| |
attachment_url | optional | In order for a URL to not be counted in the status body of an extended Tweet, provide a URL as a Tweet attachment. This URL must be a Tweet permalink, or Direct Message deep link. Arbitrary, non-Twitter URLs must remain in the status text. URLs passed to the attachment_url parameter not matching either a Tweet permalink or Direct Message deep link will fail at Tweet creation and cause an exception. |
| |
media_ids | optional | A comma-delimited list of media_ids to associate with the Tweet. You may include up to 4 photos or 1 animated GIF or 1 video in a Tweet. See Uploading Media for further details on uploading media. | 471592142565957632 | |
possibly_sensitive | optional | If you upload Tweet media that might be considered sensitive content such as nudity, or medical procedures, you must set this value to true. See Media setting and best practices for more context. |
| true |
lat | optional | 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 is no corresponding long parameter. | 37.7821120598956 | |
long | optional | The longitude of the location this Tweet refers to. The valid ranges for longitude are -180.0 to +180.0 (East is positive) inclusive. This parameter will be ignored if outside that range, if it is not a number, if geo_enabled is turned off, or if there no corresponding lat parameter. | -122.400612831116 | |
place_id | optional | A place in the world. | df51dec6f4ee2b2c | |
display_coordinates | optional | Whether or not to put a pin on the exact coordinates a Tweet has been sent from. | true | |
trim_user | optional | When set to either true , t or 1 , the response will include a user object including only the author's ID. Omit this parameter to receive the complete user object. |
| true |
enable_dmcommands | optional | When set to true , enables shortcode commands for sending Direct Messages as part of the status text to send a Direct Message to a user. When set to false , it turns off this behavior and includes any leading characters in the status text that is posted |
| true |
fail_dmcommands | optional | When set to true , causes any status text that starts with shortcode commands to return an API error. When set to false , allows shortcode commands to be sent in the status text and acted on by the API. |
| false |
card_uri | optional | Associate an ads card with the Tweet using the card_uri value from any ads card response. | card://853503245793641682 |
Example Request¶
To obtain the generated oauth_nonce, oauth_token, and oauth_signature you can use a REST tool such as Insomnia or Postman.
You many want to change the status from 'hello' to something different.
You can use also use any other OAuth helper library you'd like such as twurl.
Example Response¶
After you post successfully you should get back something that looks like this:
Twitter is an online news and social networking service on which users post and interact with messages known as 'tweets'. Twitter users are able to post from from various devices and platforms including the iOS, Android, Blackberry and via any web browser.
Twitter Status Quotes
Twitter problems in the last 24 hours
At the moment, we haven't detected any problems at Twitter. Are you experiencing issues or an outage? Leave a message in the comments section!
Twitter Outage Map
The most recent outage reports and issues originated from:Bordeaux | Website Down |
Hamburg | Website Down |
Doha | Errors |
Bemidji | Errors |
Portsmouth | Sign in |
Houston | Website Down |
Twitter Comments
Tips? Frustrations? Share them here. Useful comments include a description of the problem, city and postal code.Twitter Issues Reports
Latest outage, problems and issue reports in social media:Twitter Statuses
- JUSTICE OUT NOW (@RDStarkTony) reported
hello @TwitterSupport my account @kingtpwkwhich was created on 2012 was unjustly suspended as I've never broken any TOS, I request you to look into the case.
- nyx mini vers. (@justsayaynen) reported
Hi @TwitterSupport, there is no fleets section in my account (@B4DDEST1N). Fleets works fine on this account. The problem is not in my device, its all about the account. Could you please do smth for that, thanks!
- Bunga (@bunganau) reported
Hi, I can't send DMs or I can't reply to anyone in DM. Please fix this issue on my account. I have had this issue for the last 5 days. Thank you! @TwitterSupport
- 🧚🏼♀️ (@pisceanocean_) reported
@TwitterSupport please fix my account (case #0202995160) i still havent received a response after two weeks
- United CryptoPunks (@ucryptopunks) reported
@TwitterSupport there is no ineligible situation. my adds stopped. Urgently, can you fix this problem.. thanks a lot i got this: This account is ineligible to run Twitter Ads due to a policy violation by one or more users. Any active campaigns have been paused. ---->
- kim Hongjoong (on the weekends, keira) (@shadowteez) reported
@j3ngho @TwitterSupport TAKE THIS DOWN NOW
- emmy (@JAESJINS) reported
Hi, @TwitterSupport when I try to add someone back to a group conversation it says 'This has been reported as spam.' What is the reason for this and how can I fix this?
- 【 *****-chan 】 (@expertbaka) reported
@seitenmamusha @TwitterSupport i'm really sorry!! but yeah, i found out later that it was part of a glitch that occurred and i'm like of ALL the times to use my old number... cause they used to had me verify through e-mail and i'm very FRUSTRATED to say the least 😭
- Brent Jones (@jonesbrent570) reported
@TwitterSupport Stop caring about the fleets and clean this platform of the single/****/crypt0 bots already. It's at the point where i can't even log on without one following now. 5 years of this issue is too many.
- herefornotifs (@herefornotifs) reported
@TwitterSupport I can’t seem to sign in to my other account anymore because i don’t have access to the 2FA on my other account. I also don’t remember what email is associated with it. Please help!
- The Man Utd Way (@WasTheManUtdWay) reported
If you followed our other account and would like to help us try and get our account back, please do tweet @TwitterSupport or direct us to someone that can help. We believe we were suspended in error by a computer and it’s impossible to speak to any human about the matter.
- Manal (@Manal96490021) reported
@TwitterSupport @TwitterSupport I have problemi can't apply appeal for my unlocked account???
- 🤍 (@neptoone) reported
hello @TwitterSupport please help me to recover my account (@MOAjajan) because i cant find @moajajan account on search suggestions and the tweets from that account as well whenever i searched it. I hope you can fix it asap.
- slymptic (@slymptic_) reported
@Frankie_Cards @TwitterSupport @FrankieCabrera_ I had similar issues with my account then i was recommended to kinkhacker001 you can reach him on WhatsApp using this number +1 (240) 718‑8218 i advice you go to him he knows what to do
- A. (@xriyeon) reported
Hi @TwitterSupport, my Twitter account @yoonbxn got suspended and i never violated the Twitter rules. Could you please consider and unsuspend it? I appealed the suspension under case #0202449554 via the Help Center form but obtained no response. Thank you and please fix it!
- 🔍 Anime SauceBot (@saucenaopls) reported
@soupank @TwitterSupport people, man. I don't have a clue. Some people have unhealthy amounts of hatred in their lives. They're going to die of a stroke or an aneurysm by 60 if they don't calm down.
- Eu (@Pedrao_herminio) reported
@saucenaopls @TwitterSupport How? How did a complaint from the caption get to this type of issue?
- Read AoT CHP 139, very pain 😶 (@Just_ATR) reported
@saucenaopls @TwitterSupport twitter support is reeaaaallly slow but they do delete such tweets
- TechBoy😎⚠️ (@tedscott_) reported
@ayamous_2 @TwitterSupport I can help you fix or recover your account, Send a Dm
- Temporary (@Tempora57530510) reported
@TwitterSupport after weeks of no response. I am requesting help for the recovery and deletion of my old account @Mr_Dub1 I can still login to it but the email has been deactivated and can't be reopened. Please respond back!! I no longer wish to be on social media!
- Blair (@blair8000a) reported
@DavidSweetMP This is factually untrue. I’m surprised @TwitterSupport hasn’t asked this guy to take down his inaccurate & potentially harmful tweet. I’m further shocked that @erinotoole hasn’t sanctioned this guy. Comparing a stay at home order to an internment camp shows his ignorance.
- andmit (@andmitTV) reported
@ALTRN8MUSIC I typically don't see tweets from a muted account but if I do it's usually because someone I follow interacted with it. If it's a pretty consistent issue, try reaching out to @TwitterSupport
- Sugar Bear (@Sugar_Bear) reported
@TwitterSupport What is the problem? Why am I not getting texts anymore? #InTwitterHell #TwitterSucks
- iyh. (@youijkt) reported
Good day, @TwitterSupport my account @daisyphilen is not showing in search suggestion. Please fix this issue ASAP. I use this account for work. Thank you.
- Simon Benvenutto (@benvenutto) reported
@TwitterSupport lovelies, it appears that on iOS 14.4.2 (18D70) sharing a tweet into messages/iMessages has issues, most of the content just disappears, feels like something broke (but it’s there). On iPhone 7. Ta🙏
- Lizzie (@lizzie__fangirl) reported
@TwitterSupport Daniel Howell tweeted and I got no notification fix now your turning into @instagram when it comes to notifications
- Saul H (@spidey23) reported
@TwitterSupport Ticket form submission not working, what do I do?
- YHWH Ministries (formerly Brother Joshua) (@joshuamalinowsk) reported
@TwitterSupport Its 4/25 and its still not loading my notifications and i'm still having issues logging in.
- G Roy (@GRoy01951128) reported
@TwitterSupport if a person deletes his tweet due technical or typographical error why do you uncessarily display it in the twitter for others' view. It causes embarrassment to the person who deleted the tweet. I requested you earlier to give relief. Next request will be bitter.
- A. (@xriyeon) reported
Hi @TwitterSupport, my Twitter account @wooudz got suspended and i never violated the Twitter rules. Could you please consider and unsuspend it? I appealed the suspension under case #0202449005 via the Help Center form but obtained no response. Thank you and please fix it!