.. include:: strings.rst
Blocking
========

.. module:: blocks

.. function:: create(server_url, *args, **kwargs)

  Blocks the specified user from following the authenticating user.
  In addition the blocked user will not show in the authenticating users
  mentions or timeline (unless repeated by another user). If a follow or
  friend relationship exists it is destroyed.

  |post|

  Implements https://twitter-api.readthedocs.io/en/latest/blocks.html#post--api-blocks-create.json

  :param str server_url: |server_url|
  :rtype: dict
  :return: :ref:`user_dict`


.. function:: destroy(server_url, *args, **kwargs)

  Un-blocks the specified user from following the authenticating user.
  If relationships existed before the block was instated,
  they will not be restored.

  |post|

  Implements https://twitter-api.readthedocs.io/en/latest/blocks.html#post--api-blocks-destroy.json

  :param str server_url: |server_url|
  :rtype: dict
  :return: :ref:`user_dict`