.. include:: common.rst

Accounts
========

.. http:get:: /api/account/verify_credentials.json

  Test if supplied user credentials are valid.

  :reqheader Authorization: |auth|

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

.. http:post:: /api/account/verify_credentials.json

   Same as :http:get:`/api/account/verify_credentials.json`.

.. http:post:: /api/account/register.json

  Register a new account.

  :form nickname: name of the new user
  :form password: desired password
  :form confirm: password confirmation
  :form email: (optional) email associated with the new user
  :form fullname: |full_user_name|
  :form homepage: |user_url|
  :form location: |user_location|
  :form bio: |user_description|

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

.. http:post:: /api/account/update_profile.json

  Update profile.

  :form name: |full_user_name|
  :form url: |user_url|
  :form location: |user_location|
  :form description: |user_description|
  :form profile_link_color: (optional) color of the profile links
  :reqheader Authorization: |auth|

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

.. http:post:: /api/account/update_profile_background_image.json

  Update the authenticating user's profile background image. This method can
  also be used to enable or disable the profile background image.

  :form image: |image|
  :reqheader Authorization: |auth|

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

.. http:post:: /api/account/update_profile_image.json

  Update the authenticating user's profile image.

  :form image: |image|
  :reqheader Authorization: |auth|

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