VIvimeo
Videos\Versions

Add a version to a video

Changed on

This method adds a version to the specified video.

post/videos/{video_id}/versions

Request

  • Base URL
    https://api.vimeo.com
  • Auth
    OAuth 2
    Authorization code/oauth/authorize, token URL /oauth/access_token
    Client credentialsToken URL /oauth/authorize/client
    Scopescreate, delete, edit, email, interact, private, promo_codes, public, purchase, purchased, stats, upload, video_files
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

video_idnumber required
Example:258684937

The ID of the video.

Request body

file_namestring required

The name of the version

Example request

{
  "file_name": "untitled.mp4",
  "upload": {
    "link": "https://example.com",
    "redirect_url": "https://example.com",
    "size": "13623861"
  }
}

Response

The version was added.

activeboolean required

Whether this video version is the currently active one.

created_timestring required

The time in ISO 8601 for when the video version was created.

durationnumber nullable required

The duration of the video version in seconds.

filenamestring required

The file name of the video version.

filesizenumber nullable required

The size in byes of the video version file.

modified_timestring required

The time in ISO 8601 format when the video version was last modified.

upload_datestring nullable required

The time in ISO 8601 format when the video version was uploaded.

uristring required

The version's canonical relative URI.

Example response

{
  "active": true,
  "app": {
    "name": "Vimeo Android",
    "uri": "/apps/12345"
  },
  "created_time": "2018-03-05T21:04:47+00:00",
  "duration": 81,
  "filename": "rev2.mp4",
  "filesize": 4025322521,
  "metadata": {
    "connections": {
      "video": {
        "total": 5,
        "uri": "/videos/258684937"
      }
    }
  },
  "modified_time": "2018-09-16T09:02:40+00:00",
  "play": {
    "progressive": [
      {
        "created_time": "2017-05-16T17:21:51+00:00",
        "fps": 30,
        "height": 720,
        "link_expiration_time": "2017-05-16T17:21:51+00:00",
        "md5": "1bc29b36f623ba82aaf6724fd3b16718",
        "size": 5000000,
        "type": "source",
        "width": 1280
      }
    ],
    "status": "playable"
  },
  "upload": {
    "approach": "post",
    "size": 60000,
    "status": "complete"
  },
  "upload_date": "2018-09-16T09:02:40+00:00",
  "uri": "/videos/258684937/versions/12345",
  "user": {
    "account": "basic",
    "bio": "This is where you will find videos and news updates from the staff.",
    "created_time": "2007-01-18T16:40:11+00:00",
    "email": "user@example.com",
    "link": "https://vimeo.com/staff",
    "location": "New York City",
    "metadata": {
      "connections": {
        "albums": {
          "total": 3,
          "uri": "/users/152184/albums"
        },
        "appearances": {
          "total": 6,
          "uri": "/users/152184/appearances"
        },
        "block": {
          "total": 73,
          "uri": "/me/block"
        },
        "categories": {
          "total": 5,
          "uri": "/users/152184/categories"
        },
        "channels": {
          "total": 4,
          "uri": "/users/152184/channels"
        },
        "feed": {
          "uri": "/users/152184/feed"
        },
        "folders": {
          "total": 9,
          "uri": "/me/folders"
        },
        "followers": {
          "total": 12,
          "uri": "/users/152184/followers"
        },
        "following": {
          "total": 47,
          "uri": "/users/152184/following"
        },
        "groups": {
          "total": 2,
          "uri": "/users/152184/groups"
        },
        "likes": {
          "total": 300,
          "uri": "/users/152184/likes"
        },
        "moderated_channels": {
          "total": 1,
          "uri": "/users/152184/channels?filter=moderated"
        },
        "pictures": {
          "total": 3,
          "uri": "/users/152184/pictures"
        },
        "portfolios": {
          "total": 5,
          "uri": "/users/152184/portfolios"
        },
        "recommended_channels": {
          "total": 4,
          "uri": "/me/recommendations/channels"
        },
        "recommended_users": {
          "total": 6,
          "uri": "/me/recommendations/users"
        },
        "shared": {
          "total": 15,
          "uri": "/users/152184/shared/videos"
        },
        "videos": {
          "total": 36,
          "uri": "/users/152184/videos"
        },
        "watched_videos": {
          "total": 322,
          "uri": "/me/watched/videos"
        },
        "watchlater": {
          "total": 14,
          "uri": "/users/152184/watchlater"
        }
      },
      "interactions": {
        "add_privacy_user": {
          "uri": "/channels/152184/privacy/users"
        },
        "block": {
          "added": true,
          "added_time": "2017-05-16T15:05:43+00:00",
          "uri": "/me/block/3766357"
        },
        "follow": {
          "added": true,
          "uri": "/users/152184/following/3766357"
        },
        "report": {
          "uri": "/users/152184/report"
        }
      }
    },
    "name": "Vimeo Staff",
    "pictures": {
      "active": true,
      "resource_key": "dc724af18fbdd4e59189f5fe768a5f8311527050",
      "sizes": [
        {
          "height": 720,
          "link": "https://i.vimeocdn.com/video/581495283_1280x720.jpg?r=pad",
          "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F581495283_1280x720.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png",
          "width": 1280
        }
      ],
      "type": "caution",
      "uri": "/users/152184/pictures/12345"
    },
    "preferences": {
      "videos": {
        "privacy": {
          "add": true,
          "comments": "anybody",
          "download": true,
          "embed": "private",
          "view": "anybody"
        }
      }
    },
    "resource_key": "bac1033deba2310ebba2caec33c23e4beea67aba",
    "upload_quota": {
      "lifetime": {
        "free": 5000000,
        "max": 5368709120,
        "used": 5368704120
      },
      "periodic": {
        "free": 5000000,
        "max": 5368709120,
        "reset_date": "2029-03-13T02:35:13-04:00",
        "used": 5368704120
      },
      "space": {
        "free": 5000000,
        "max": 5368709120,
        "showing": "lifetime",
        "used": 5368704120
      }
    },
    "uri": "/users/152184",
    "websites": [
      {
        "description": "Follow us on Twitter!",
        "link": "https://twitter.com/vimeo",
        "name": "Twitter"
      }
    ]
  }
}

Changes