retweet method

Future<Tweet> retweet({ required String id, bool? trimUser, String tweetMode = 'extended', bool? includeExtEditControl, TransformResponse<Tweet> transform = defaultTweetTransform, })

Retweets a tweet. Returns the original Tweet with Retweet details embedded.

id: The numerical ID of the desired status.

trimUser: When true, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.

includeExtEditControl: The includeExtEditControl node will not be included when set to false. See https://developer.twitter.com/en/docs/twitter-api/v1/edit-tweets

tweetMode: When set to extended, uses the extended Tweets. See https://developer.twitter.com/en/docs/tweets/data-dictionary/overview/intro-to-tweet-json#extendedtweet.

transform: Can be used to parse the request. By default, the response is parsed in an isolate.

See https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-unretweet-id.

Implementation

Future<Tweet> retweet({
  required String id,
  bool? trimUser,
  String tweetMode = 'extended',
  bool? includeExtEditControl,
  TransformResponse<Tweet> transform = defaultTweetTransform,
}) async {
  final body = <String, String>{}
    ..addParameter('tweet_mode', tweetMode)
    ..addParameter('trim_user', trimUser)
    ..addParameter('include_ext_edit_control', includeExtEditControl);

  return client
      .post(
        Uri.https('api.twitter.com', '1.1/statuses/retweet/$id.json'),
        body: body,
      )
      .then(transform);
}