3.4

  • The Clip representation is the new default for On Demand videos.

Added

Resources

  • The following On Demand resources have added:
    • On /ondemand/pages/{ondemand_id}/videos/{video_id}, GET requests now return a 200 OK with a Clip representation.
  • The following Videos resources have added:
    • On POST requests to /me/videos, a 400 Bad Request with a Error representation is now returned: If a `type` payload parameter was supplied instead of `upload.approach`.
    • The following parameters have been added to POST on /me/videos:
      • content_rating
      • description
      • embed.buttons.embed
      • embed.buttons.fullscreen
      • embed.buttons.hd
      • embed.buttons.like
      • embed.buttons.scaling
      • embed.buttons.share
      • embed.buttons.watchlater
      • embed.color
      • embed.logos.custom.active
      • embed.logos.custom.link
      • embed.logos.custom.sticky
      • embed.logos.vimeo
      • embed.playbar
      • embed.title.name
      • embed.title.owner
      • embed.title.portrait
      • embed.volume
      • license
      • locale
      • name
      • password
      • privacy.add
      • privacy.comments
      • privacy.download
      • privacy.embed
      • privacy.view
      • ratings.mpaa.reason
      • ratings.tv.reason
      • spatial.director_timeline
      • spatial.director_timeline.pitch
      • spatial.director_timeline.roll
      • spatial.director_timeline.time_code
      • spatial.director_timeline.yaw
      • spatial.field_of_view
      • spatial.projection
      • spatial.stereo_format
      • upload.approach
      • upload.link
      • upload.redirect_url
      • upload.size
    • On /me/videos, POST requests now return a 201 Created with a Clip representation.
    • On POST requests to /users/{user_id}/videos, a 400 Bad Request with a Error representation is now returned: If a `type` payload parameter was supplied instead of `upload.approach`.
    • The following parameters have been added to POST on /users/{user_id}/videos:
      • content_rating
      • description
      • embed.buttons.embed
      • embed.buttons.fullscreen
      • embed.buttons.hd
      • embed.buttons.like
      • embed.buttons.scaling
      • embed.buttons.share
      • embed.buttons.watchlater
      • embed.color
      • embed.logos.custom.active
      • embed.logos.custom.link
      • embed.logos.custom.sticky
      • embed.logos.vimeo
      • embed.playbar
      • embed.title.name
      • embed.title.owner
      • embed.title.portrait
      • embed.volume
      • license
      • locale
      • name
      • password
      • privacy.add
      • privacy.comments
      • privacy.download
      • privacy.embed
      • privacy.view
      • ratings.mpaa.reason
      • ratings.tv.reason
      • spatial.director_timeline
      • spatial.director_timeline.pitch
      • spatial.director_timeline.roll
      • spatial.director_timeline.time_code
      • spatial.director_timeline.yaw
      • spatial.field_of_view
      • spatial.projection
      • spatial.stereo_format
      • upload.approach
      • upload.link
      • upload.redirect_url
      • upload.size
    • On /users/{user_id}/videos, POST requests now return a 201 Created with a Clip representation.

Changed

Resources

  • The following Videos resources have changed:
    • On /me/videos, POST requests now return a application/vnd.vimeo.video+json Content-Type header.
    • On /users/{user_id}/videos, POST requests now return a application/vnd.vimeo.video+json Content-Type header.

Removed

Representations

  • The User representation has removed the following fields:
    • upload_quota.quota.hd
    • upload_quota.quota.sd
  • privacy.forums has been removed from the Group representation.

Resources

  • The following On Demand resources have removed:
    • On /ondemand/pages/{ondemand_id}/videos/{video_id}, GET requests no longer return a 200 OK with a On Demand Video representation.
  • The following Videos resources have removed:
    • The following parameters have been removed from POST on /me/videos:
      • link
      • redirect_url
      • type
    • On /me/videos, POST requests no longer return a 201 Created with a Upload Attempt representation.
    • The following parameters have been removed from POST on /users/{user_id}/videos:
      • link
      • redirect_url
      • type
    • On /users/{user_id}/videos, POST requests no longer return a 201 Created with a Upload Attempt representation.

3.3.11

  • GET /users/{user_id}/tickets/{ticket} now returns a full Upload Ticket representation if the ticket exists.

Added

Resources

  • The following Videos resources have added:
    • On /users/{user_id}/uploads/{upload}, GET requests now return a 200 OK with a Upload Attempt representation.

Removed

Resources

  • The following Videos resources have removed:
    • On /users/{user_id}/uploads/{upload}, GET requests no longer return a 204 No Content with a Upload Attempt representation.

3.3.9

  • Add a parent_folder field to the Video representation and a folders connection to the User representation.

Added

Representations

  • The User representation has added the following fields:
    • metadata.connections.folders
    • metadata.connections.folders.options
    • metadata.connections.folders.total
    • metadata.connections.folders.uri
  • parent_folder has been added to the Clip representation.

3.3.8

  • Deprecated metadata.connections.activities in the User representation.

Removed

Representations

  • The User representation has removed the following fields:
    • metadata.connections.activities
    • metadata.connections.activities.options
    • metadata.connections.activities.uri

3.3.6

  • In the Clip representation, review_link is removed in favor of review_page. The review page link can still be retrieved through review_page.link.

Added

Resources

  • The following Videos resources have added:
    • A review_page.active request parameter was added to PATCH on /videos/{video_id}.
    • A review_page.active request parameter was added to POST on /me/videos.
    • A review_page.active request parameter was added to POST on /users/{user_id}/videos.

Removed

Representations

  • review_link has been removed from the Clip representation.

Resources

  • The following Videos resources have removed:
    • The review_link request parameter has been removed from PATCH requests on /videos/{video_id}.
    • The review_link request parameter has been removed from POST requests on /me/videos.
    • The review_link request parameter has been removed from POST requests on /users/{user_id}/videos.

3.3.3

Removed

Representations

  • upload_link_secure has been removed from the Upload Attempt representation.

3.3

Added

Representations

  • The Category representation has added the following fields:
    • metadata.interactions
    • metadata.interactions.follow
    • metadata.interactions.follow.added
    • metadata.interactions.follow.added_time
    • metadata.interactions.follow.uri
  • The Clip representation has added the following fields:
    • categories
    • metadata.connections.recommendations
    • metadata.connections.recommendations.options
    • metadata.connections.recommendations.uri
  • The On Demand Page representation has added the following fields:
    • episodes.buy.active
    • episodes.buy.price
    • metadata.connections.metadata.connections.videos.extra_total
    • metadata.connections.metadata.connections.videos.main_total
    • metadata.interactions
  • The On Demand Video representation has added the following fields:
    • metadata
    • metadata.connections.season
    • metadata.connections.season.name
    • metadata.connections.season.options
    • metadata.connections.season.uri
    • metadata.interactions.likes
    • metadata.interactions.likes.added
    • metadata.interactions.likes.added_time
    • metadata.interactions.likes.uri
    • metadata.interactions.watchlater
    • metadata.interactions.watchlater.added
    • metadata.interactions.watchlater.added_time
    • metadata.interactions.watchlater.uri

Resources

  • The following Groups resources have added:
    • On /groups/{group_id}/videos/{video_id}, PUT requests now return a 200 OK with a Clip representation.
  • The following Videos resources have added:
    • On /videos/{video_id}/tags, PUT requests now return a 200 OK with a Tag representation.
    • On /videos/{video_id}/credits, POST requests now return a 201 Created with a Credit representation.
    • On /channels/{channel_id}/videos/{video_id}/credits, POST requests now return a 201 Created with a Credit representation.
    • On /videos/{video_id}/privacy/users/{user_id}, PUT requests now return a 200 OK with a User representation.
    • GET on /channels/{channel_id}/videos/{video_id}/recommendations was added.

Changed

Resources

  • The following Groups resources have changed:
    • On /groups/{group_id}/videos/{video_id}, PUT requests now return a application/vnd.vimeo.video+json Content-Type header.
  • The following Videos resources have changed:
    • On /videos/{video_id}/tags, PUT requests now return a application/vnd.vimeo.tag+json Content-Type header.
    • On /videos/{video_id}/credits, POST requests now return a application/vnd.vimeo.credit+json Content-Type header.
    • On /channels/{channel_id}/videos/{video_id}/credits, POST requests now return a application/vnd.vimeo.credit+json Content-Type header.
    • On /videos/{video_id}/privacy/users/{user_id}, PUT requests now return a application/vnd.vimeo.user+json Content-Type header.

Removed

Representations

  • default has been removed from the Picture representation.
  • embed_presets has been removed from the Clip representation.
  • The On Demand Page representation has removed the following fields:
    • episodes.purchase.active
    • episodes.purchase.price
    • regions
    • regions.code
    • regions.name

Resources

  • The following Groups resources have removed:
    • PUT on /groups/{group_id}/videos/{video_id} no longer returns a 204 No Content.
  • The following Videos resources have removed:
    • PUT on /videos/{video_id}/tags no longer returns a 201 Created.
    • POST on /videos/{video_id}/credits no longer returns a 201 Created.
    • POST on /channels/{channel_id}/videos/{video_id}/credits no longer returns a 201 Created.
    • PUT on /videos/{video_id}/privacy/users/{user_id} no longer returns a 204 No Content.

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 Picture representation has added the following fields:
    • default
    • link
  • 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
  • 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 Comment representation has added the following fields:
    • metadata.connections.replies
    • metadata.connections.replies.options
    • metadata.connections.replies.total
    • metadata.connections.replies.uri

Resources

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

Changed

Resources

  • The following Channels resources have changed:
    • On /channels/{channel_id}, PATCH requests now return a application/vnd.vimeo.channel+json Content-Type header.
  • The following Videos resources have changed:
    • On /videos/{video_id}, PATCH requests now return a application/vnd.vimeo.video+json Content-Type header.
    • On /videos/{video_id}/comments/{comment_id}, PATCH requests now return a application/vnd.vimeo.comment+json Content-Type header.
    • On /videos/{video_id}/credits/{credit_id}, PATCH requests now return a application/vnd.vimeo.credit+json Content-Type header.

Removed

Representations

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

Resources

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

3.1

Added

Representations

  • header has been added to the Channel 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 Users resources have added:
    • On /me/feed, GET requests now return a 200 OK with a Activity 3.1 representation.
    • On /users/{user_id}/feed, GET requests now return a 200 OK with a Activity 3.1 representation.
    • On /me/pictures, POST requests now return a 200 OK with a Picture representation.
    • On /users/{user_id}/pictures, POST requests now return a 200 OK with a Picture representation.

Changed

Resources

  • The following Users resources have changed:
    • On /me/feed, GET requests now return a application/vnd.vimeo.activity+json Content-Type header.
    • On /users/{user_id}/feed, GET requests now return a application/vnd.vimeo.activity+json Content-Type header.
    • On /me/pictures, POST requests now return a application/vnd.vimeo.picture+json Content-Type header.
    • On /users/{user_id}/pictures, POST requests now return a application/vnd.vimeo.picture+json Content-Type header.

Removed

Representations

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

Resources

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

3.0

Added

Representations

  • content_filter has been added to the User representation.
  • location has been added to the Picture representation.
  • 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

Send Feedback