You can move a video to another collection. When providing null as collection, it will be moved to the root of the space (or when archived, to the root of the archive).

Private videos

Send visibility: "private" to require a playback JWT, or visibility: "public" for public access. This requires a read-write API key. New videos default to public. See Secure video playback.

Visibility changes run in the background. A pending update returns 202 Accepted with the last confirmed visibility. Poll GET /v1/videos/{id} until it returns 200 OK with the requested value (public or private). While pending, GET also returns 202.

Request (optional)

{
  "name": "new name", // set new name
  "collection": "ubg50fRgMoWlCUU" // to move to another collection
}

Response

{
  "created": 1643723737, // when this video embed was created
  "duration": null, // duration of the video
  "width": null, // width of the video in pixels
  "height": null, // height of the video in pixels
  "id": "ubg50apemJaHEYZ", // the ID if you want to store it for your user and possibly webhooks
  "last_upload": null, // when a video has been uploaded
  "name": null, // name of the file or chosen name
  "visibility": "public",
  "object": "video", // the type of object you're looking at
  "poster_image": null, // uploaded poster or first frame of video when uploaded
  "size": null, // size of the video
  "renditions": [],
  "subtitles": []
}