DELETE /2/users/:source_user_id/blocking/:target_user_id

Allows a user or authenticated user ID to unblock another user.

The request succeeds with no action when the user sends a request to a user they're not blocking or have already unblocked.

Endpoint URL

https://api.twitter.com/2/users/:source_user_id/blocking/:target_user_id

Authentication and rate limits

Authentication methods supported by this endpoint	OAuth 1.0a is also available for this endpoint. OAuth 2.0 Authorization Code with PKCE
Rate limit	User rate limit (User context): 50 requests per 15-minute window per each authenticated user

Authentication methods
supported by this endpoint

OAuth 1.0a is also available for this endpoint.

OAuth 2.0 Authorization Code with PKCE

Rate limit

User rate limit (User context): 50 requests per 15-minute window per each authenticated user

OAuth 2.0 scopes required by this endpoint

tweet.read

users.read

block.write

Learn more about OAuth 2.0 Authorization Code with PKCE

Path parameters

Name	Type	Description
`source_user_id` Required	string	The user ID who you would like to initiate an unblock on behalf of. The user’s ID must correspond to the user ID of the authenticating user, meaning that you must pass the Access Tokens associated with the user ID when authenticating your request.
`target_user_id` Required	string	The user ID of the user that you would like the `source_user_id` to unblock.

Example code with offical SDKs

      (async () => {
  try {
    const unblockUser = await twitterClient.users.usersIdUnblock(
      //The ID of the user that is requesting to unblock the target user
      "2244994945",

      //The ID of the user that the source user is requesting to unblock
      "6253282"
    );
    console.dir(unblockUser, {
      depth: null,
    });
  } catch (error) {
    console.log(error);
  }
})();

      // Set the params values

// String | The ID of the user that is requesting to unblock the target user
String sourceUserId = "2244994945";

// String | The ID of the user that the source user is requesting to unblock
String targetUserId = "6253282";

try {
    UsersBlockingMutationResponse result = apiInstance.users().usersIdUnblock(sourceUserId, targetUserId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling UsersApi#usersIdUnblock");
    System.err.println("Status code: " + e.getCode());
    System.err.println("Reason: " + e.getResponseBody());
    System.err.println("Response headers: " + e.getResponseHeaders());
    e.printStackTrace();
}

Example responses

      {
  "data": {
    "blocking": false
  }
}

Response fields

Name	Type	Description
`blocking`	boolean	Indicates whether the user is blocking the specified user as a result of this request. The returned value is `false` for a successful unblock request.