.. include:: common.rst

Blocking
========

.. http:post:: /api/blocks/create.json

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

  :form user_id: |user_id|
  :form screen_name: |screen_name|
  :reqheader Authorization: |auth|

  **Example response**: :ref:`user_object`

.. http:post:: /api/blocks/destroy.json

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

  :form user_id: |user_id|
  :form screen_name: |screen_name|
  :reqheader Authorization: |auth|

  **Example response**: :ref:`user_object`