.. include:: common.rst Friendships =========== .. http:post:: /api/friendships/create.json Subscribe to status updates from specified user. :form user_id: |user_id| :form screen_name: |screen_name| :reqheader Authorization: |auth| **Example response**: :ref:`user_object` .. http:post:: /api/friendships/destroy.json Unsubscribe to status updates from specified user. :form user_id: |user_id| :form screen_name: |screen_name| :reqheader Authorization: |auth| **Example response**: :ref:`user_object` .. http:get:: /api/friendships/exists.json Show if ``source_user`` follows ``target_user``. :query source_user: user that is following. Can be an ID or username :query target_user: user that is following. Can be an ID or username **Example response**: .. sourcecode:: json true .. http:get:: /api/friendships/show.json Show detailed information about the relationship between two users. :query int source_id: (optional) ID of the subject user :query str source_screen_name: (optional) handle of the subject user :query int target_id: (optional) ID of the target user :query str target_screen_name: (optional) handle of the target user **Example response**: :ref:`relationship_object`