3.2

  • Many new resource connections have been added to our resource representations.
  • Before 3.2, it was hard to check if a picture was the Vimeo default (vertical color bars), or an actual thumbnail or profile picture. Now, the field "default" will hold the value true when the picture is the Vimeo default.
  • Many API calls pre 3.2 would return a 204 status code and an empty body. To reduce the necessary amount of API calls necessary in a real world application, many of those now return a 200 status code and a resource representation. One example of this is PATCH on /channels/{channel_id} will now return the full channel representation along with a 200 status code
  • All endpoints should now return the proper content-type header
  • The stats fields have been deprecated on the Album, Category, Clip and Group representations. These stats can all be found now in those representations connections within the total field.

Added

Representations

  • The Comment representation has added the following fields:
    • metadata.connections.replies
    • metadata.connections.replies.options
    • metadata.connections.replies.total
    • metadata.connections.replies.uri
  • The Picture representation has added the following fields:
    • default
    • link
  • The Portfolio representation has added the following fields:
    • metadata
    • metadata.connections
    • metadata.connections.videos
    • metadata.connections.videos.options
    • metadata.connections.videos.total
    • metadata.connections.videos.uri
  • The Presets representation has added the following fields:
    • metadata
    • metadata.connections
    • metadata.connections.videos
    • metadata.connections.videos.options
    • metadata.connections.videos.total
    • metadata.connections.videos.uri

Resources

  • The following Channels resources have added:
    • On /channels/{channel_id}, PATCH requests now returns a 200 OK with a Channel representation.
    • On /channels, POST requests now returns a 200 OK with a Channel representation.
  • The following Me resources have added:
    • On /me, PATCH requests now returns a 200 OK with a User representation.
    • On /me/pictures/{portraitset_id}, PATCH requests now returns a 200 OK with a Picture representation.
  • The following Users resources have added:
    • On /users/{user_id}, PATCH requests now returns a 200 OK with a User representation.
    • On /users/{user_id}/pictures/{portraitset_id}, PATCH requests now returns a 200 OK with a Picture representation.
  • The following Albums resources have added:
    • On /me/albums/{album_id}, PATCH requests now returns a 200 OK with a Album representation.
    • On /me/albums, POST requests now returns a 200 OK with a Album representation.
    • On /users/{user_id}/albums/{album_id}, PATCH requests now returns a 200 OK with a Album representation.
    • On /users/{user_id}/albums, POST requests now returns a 200 OK with a Album representation.
  • The following Videos resources have added:
    • On /videos/{video_id}, PATCH requests now returns a 200 OK with a Clip representation.
    • On /videos/{video_id}/comments/{comment_id}, PATCH requests now returns a 200 OK with a Comment representation.
    • On /videos/{video_id}/credits/{credit_id}, PATCH requests now returns a 200 OK with a Credit representation.
    • /videos/{video_id}/pictures/{picture_id} has been added with support for the following HTTP methods:
    • /videos/{video_id}/pictures has been added with support for the following HTTP methods:

Changed

Resources

Removed

Representations

  • The Album representation has removed the following fields:
    • stats
    • stats.videos
  • The Category representation has removed the following fields:
    • stats
    • stats.channels
    • stats.groups
    • stats.users
    • stats.videos
  • The Clip representation has removed the following fields:
    • stats.comments
    • stats.likes
  • The Group representation has removed the following fields:
    • stats
    • stats.albums
    • stats.moderators
    • stats.topics
    • stats.users
    • stats.videos
  • sizes.type has been removed from the Picture representation.

Resources

  • The following Channels resources have removed:
    • PATCH on /channels/{channel_id} no longer will return a 204 No Content.
    • On /channels, POST requests no longer returns a 201 Created with a Channel representation.
  • The following Me resources have removed:
    • On /me, PATCH requests no longer returns a 204 No Content with a User representation.
    • On /me/pictures/{portraitset_id}, PATCH requests no longer returns a 204 No Content with a Picture representation.
  • The following Users resources have removed:
    • On /users/{user_id}, PATCH requests no longer returns a 204 No Content with a User representation.
    • On /users/{user_id}/pictures/{portraitset_id}, PATCH requests no longer returns a 204 No Content with a Picture representation.
  • The following Albums resources have removed:
    • On /me/albums/{album_id}, PATCH requests no longer returns a 204 No Content with a Album representation.
    • On /me/albums, POST requests no longer returns a 201 Created with a Album representation.
    • On /users/{user_id}/albums/{album_id}, PATCH requests no longer returns a 204 No Content with a Album representation.
    • On /users/{user_id}/albums, POST requests no longer returns a 201 Created with a Album representation.
  • The following Videos resources have removed:
    • PATCH on /videos/{video_id} no longer will return a 204 No Content.
    • PATCH on /videos/{video_id}/comments/{comment_id} no longer will return a 204 No Content.
    • PATCH on /videos/{video_id}/credits/{credit_id} no longer will return a 204 No Content.

3.1

Added

Representations

  • header has been added to the Channel representation.
  • header has been added to the Group representation.

Resources

  • The following On Demand resources have added:
    • /ondemand/pages/{ondemand_id}/pictures/{poster_id} has been added with support for the following HTTP methods:
      • GET
      • PATCH
    • /ondemand/pages/{ondemand_id}/pictures has been added with support for the following HTTP methods:
      • GET
      • POST
  • The following Me resources have added:
    • On /me/feed, GET requests now returns a 200 OK with a Activity 3.1 representation.
    • On /me/pictures, POST requests now returns a 200 OK with a Picture representation.
  • The following Users resources have added:
    • On /users/{user_id}/feed, GET requests now returns a 200 OK with a Activity 3.1 representation.
    • On /users/{user_id}/pictures, POST requests now returns a 200 OK with a Picture representation.

Changed

Resources

  • The following Me resources have changed:
    • On /me/feed, GET requests will return a application/vnd.vimeo.activity Content-Type header.
    • On /me/pictures, POST requests will return a application/vnd.vimeo.picture Content-Type header.
  • The following Users resources have changed:

Removed

Representations

  • The Channel representation has removed the following fields:
    • stats
    • stats.users
    • stats.videos
  • location has been removed from the Picture representation.

Resources

  • The following Me resources have removed:
    • On /me/feed, GET requests no longer returns a 200 OK with a Clip representation.
    • POST on /me/pictures no longer will return a 201 Created.
  • The following Users resources have removed:
    • On /users/{user_id}/feed, GET requests no longer returns a 200 OK with a Clip representation.
    • POST on /users/{user_id}/pictures no longer will return a 201 Created.

3.0

Added

Representations

  • The Clip representation has added the following fields:
    • metadata.connections.comments
    • metadata.connections.comments.options
    • metadata.connections.comments.total
    • metadata.connections.comments.uri
    • metadata.connections.pictures
    • metadata.connections.pictures.options
    • metadata.connections.pictures.total
    • metadata.connections.pictures.uri
  • location has been added to the Picture representation.
  • content_filter has been added to the User representation.

Send Feedback