POST_users_id_friends.md

User Resources

POST users/:id/friends

Description

Add the user to the list of followers.

---

Requires authentication

• A valid Consumer Key must be provided in consumer_key parameter.
• Alternatively, a valid OAuth request with an authorized Access Token will be accepted.

---

Parameters

• id (required) — ID of the User to add to the followers list.

---

Return format

A JSON array with followed User object.

---

Errors

All known errors cause the resource to return HTTP error code header together with a JSON array containing at least 'status' and 'error' keys describing the source of error.

• 403 Forbidden — The user requested has been disabled or already in followers list.
• 404 Not Found — User does not exist in our database.

---

Example

Request

POST v1/users/827595/friends

Return

{
  user: {
    id: 827595,
    username: "voldemarpetruskauskus",
    firstname: "Voldemar",
    lastname: "Petruskauskus",
    birthday: null,
    sex: 0,
    city: "",
    state: "",
    country: "",
    registration_date: "2012-05-15T11:19:42-04:00",
    about: "Voldemar",
    domain: null,
    upgrade_status: 9,
    fotomoto_on: false,
    locale: "en",
    show_nude: false,
    store_on: false,
    contacts: { },
    equipment: { }
  }
}