Accounts

GET /api/account/verify_credentials.json

Test if supplied user credentials are valid.

Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: User object

POST /api/account/verify_credentials.json

Same as GET /api/account/verify_credentials.json.

POST /api/account/register.json

Register a new account.

Form Parameters:
 
  • nickname – name of the new user
  • password – desired password
  • confirm – password confirmation
  • email – (optional) email associated with the new user
  • fullname – full name associated with the profile
  • homepage – URL associated with the profile. Will be prepended with “http://” if not present
  • location – the city or country describing where the user is located. The contents are not normalized or geocoded in any way
  • bio – user’s description

Example response: User object

POST /api/account/update_profile.json

Update profile.

Form Parameters:
 
  • name – full name associated with the profile
  • url – URL associated with the profile. Will be prepended with “http://” if not present
  • location – the city or country describing where the user is located. The contents are not normalized or geocoded in any way
  • description – user’s description
  • profile_link_color – (optional) color of the profile links
Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: User object

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 Parameters:
 
  • image – image to upload, encoded in multipart/form-data
Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: User object

POST /api/account/update_profile_image.json

Update the authenticating user’s profile image.

Form Parameters:
 
  • image – image to upload, encoded in multipart/form-data
Request Headers:
 
  • Authorization – username and password or OAuth token to authenticate

Example response: User object