complete object documentation - v3 notes.

Author: ramz

Diff for: endpoints/albums.md

@@ -8,72 +8,23 @@ These are the API calls that you can use to retrieve albums, the photos in those
 ##Available endpoints
 ***
 
-* `/albums`, [GET](albums/GET_albums.md#files), POST (not available yet)
-* `/albums/recommended`, [GET](https://github.com/eyeem/API/blob/master/endpoints/albums/GET_albums_recommended.md#files)
-* `/albums/#{id}`, [GET](https://github.com/eyeem/API/blob/master/endpoints/albums/GET_albums_id.md#files)
-* `/albums/#{id}/photos`, [GET](https://github.com/eyeem/API/blob/master/endpoints/albums/GET_albums_id_photos.md#files)
+* `/albums`, [GET](albums/GET_albums.md#files)
 * `/albums/recommended`, [GET](albums/GET_albums_recommended.md#files)
 * `/albums/#{id}`, [GET](albums/GET_albums_id.md#files)
-* `/albums/#{id}/photos`, [GET](albums/GET_albums_id_photos.md#files)
-* `/albums/#{id}/hide`, GET, POST, DELETE << will it stay HIDE or change to a different name?
-* `/albums/#{id}/photos/#{photo_id}`, [PUT](albums/PUT_albums_id_photos_id.md#files),[DELETE](albums/DELETE_albums_id_photos_id.md#files) (see relevant endpoint in [photos](https://github.com/eyeem/API/blob/master/endpoints/photos.md#files))
-* `/albums/#{id}/likers` [GET](albums/GET_albums_id_likers.md#files)
-* `/albums/#{id}/likers/#{user_id}`, [GET](albums/GET_albums_id_likers_id.md#files), [PUT](albums/PUT_albums_id_likers_id.md#files), [DELETE](albums/DELETE_albums_id_likers_id.md#files)
+* `/albums/{album_id}/acceptInvites`, [POST](albums/POST_albums_id_accept_invites.md#files)
+* `/albums/#{id}/favoriters` [GET](albums/GET_albums_id_likers.md#files), [POST](albums/POST_albums_id_likers.md#files)
+* `/albums/#{id}/favoriters/#{user_id}`, [GET](albums/GET_albums_id_favoriters_id.md#files), [PUT](albums/PUT_albums_id_favoriters_id.md#files), [DELETE](albums/DELETE_albums_id_favoriters_id.md#files)
 * `/albums/#{id}/contributors`, [GET](albums/GET_albums_id_contributors.md#files)
 * `/albums/#{id}/contributors/#{user_id}`, [GET](albums/GET_albums_id_contributors_id.md#files)
+* `/albums/#{id}/view`, [POST](albums/POST_albums_id_view.md#files)
+* `/albums/#{id}/photos`, [GET](albums/GET_albums_id_photos.md#files)
+* `/albums/#{id}/photos/#{photo_id}`, [GET](albums/GET_albums_id_photos_id.md#files),[PUT](albums/PUT_albums_id_photos_id.md#files),[DELETE](albums/DELETE_albums_id_photos_id.md#files)
+* `/collections`, [GET](albums/GET_albums_id_collections.md#files)
+* `/albums/#{id}/relatedAlbums`, [GET](albums/GET_albums_id_related_albums.md#files)
+* `/albums/#{id}/weather`, [GET](albums/GET_albums_id_weather.md#files)
+* `/albums/#{id}/venueCategories`, [GET](albums/GET_albums_id_venue_categories.md#files)
 * `/albums/#{id}/share`, [POST](albums/POST_albums_id_share.md#files)
-* `/albums/#{id}/discover`, POST
-* `/albums/#{id}/view`, POST
-
-Special endpoints (will be deprecated soon)
-
-* popular album: `/albums/dynamic:10`
-* radius album: `/albums/radius:#{latitude}:#{longitude}`
-
-
-##Representation
-***
-
-The various possible representations of an album (simple,detailed) are presented and described in the [model](../resources/model.md#files) page.
-
-
-
-##GET
-***
-
-* [`/albums`](albums/GET_albums.md#files)
-* [`/albums/recommended`](albums/GET_albums_recommended.md#files)
-* [`/albums/#{id}`](albums/GET_albums_id.md#files)
-* [`/albums/#{id}/photos`](albums/GET_albums_id_photos.md#files)
-* `/albums/#{id}/hide`
-* [`/albums/#{id}/likers`](albums/GET_albums_id_likers.md#files)
-* [`/albums/#{id}/likers/#{user_id}`](albums/GET_albums_id_likers_id.md#files)
-* [`/albums/#{id}/contributors`](albums/GET_albums_id_contributors.md#files)
-* [`/albums/#{id}/contributors/#{user_id}`](albums/GET_albums_id_contributors_id.md#files)
-* [`/albums/#{id}/relatedAlbums`](albums/GET_albums_id_related_albums.md#files)
-* [`/albums/#{id}/venueCategories`](albums/GET_albums_id_venue_categories.md#files)
-
-
-##PUT
-***
-
-* [`/albums/#{id}/photos/#{photo_id}`](albums/PUT_albums_id_photos_id.md#files)
-* [`/albums/#{id}/likers/#{user_id}`](albums/PUT_albums_id_photos_id.md#files)
-
-
-
-##POST
-***
-
-* `/albums/#{id}/hide`
-* [`/albums/#{id}/share`](albums/POST_albums_id_share.md#files)
-* `/albums/#{id}/discover`
-* `/albums/#{id}/view`
-
-##DELETE
-***
+* `/albums/{id}/hide`, [POST](albums/POST_albums_id_hide.md#files)
+* `/albums/{id}/mute`, [GET](albums/GET_albums_id_mute.md#files),[POST](albums/POST_albums_id_mute.md#files), [DELETE](albums/DELETE_albums_id_mute.md#files)
 
 
-* `/albums/#{id}/hide`
-* [`/albums/#{id}/photos/#{photo_id}`](albums/DELETE_albums_id_photos_id.md#files)
-* [`/albums/#{id}/likers/#{user_id}`](albums/DELETE_albums_id_photos_id.md#files)

Diff for: endpoints/albums/DELETE_albums_id_likers_id.md renamed to endpoints/albums/DELETE_albums_id_favoriters_id.md

@@ -1,10 +1,10 @@
-# DELETE /albums/#{id}/likers/#{user_id} 
+# DELETE /albums/#{id}/favoriters/#{user_id} 
 ***
-`/albums/#{id}/likers/#{user_id}`
+`/albums/#{id}/favoriters/#{user_id}`
 
 ### Description
 ***
-Unlike an album.
+unfavorite an album.
 
 ### Parameters
 ***
@@ -19,17 +19,3 @@ Unlike an album.
 
 
 200 if success
-
-[Errors](../../resources/errors.md#files)
-
-### Examples
-***
-
-`https://api.eyeem.com/v2/albums/1234/likers/1013`
-
-
-
-
-
-
- 

Diff for: endpoints/albums/DELETE_albums_id_mute.md

@@ -0,0 +1,21 @@
+# DELETE /albums/#{id}/mute 
+***
+`/albums/#{id}/mute`
+
+### Description
+***
+Unmute an album from a specific user's discovery.
+
+
+### Parameters
+***
+
+|header| description| type |required? |default|
+|:---------|:--------------|:----------:|:------------:|:------------:|
+|**id**| the id of the album to share|integer|x||
+|**parameter**| **description**| **type** |**required?** |**default**|
+
+
+### Response
+***
+200 if success