Set video privacy

Change who can watch a video and where it can be embedded.

PUT https://cotlet.dev/api/v1/vimeo/videos/{video_id}/privacy

write Confirm

Sets the viewing privacy and optionally the embed rule. Privacy is public, unlisted, password, embed_only or private; unlisted, password and embed_only need a paid plan. Embed is anywhere, nowhere or domains. A private video cannot play when embedded elsewhere. A public video appears in search engines and on your profile. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: set_video_privacy
NameTypeDescription
video_id string required string Video ID from search_videos, the number in vimeo.com/{id}.
privacy enum required enum public, unlisted, password, embed_only or private.
password string string Required when privacy is password.
embed enum enum anywhere, nowhere or domains.
embed_domains string[] string[] Allowed domains when embed is domains. Up to 50.

Request

cURL
curl -X PUT https://cotlet.dev/api/v1/vimeo/videos/video_8c41d2/privacy \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"privacy":"public"}'
Python
result = client.call("vimeo", "set_video_privacy", {"video_id":"video_8c41d2","privacy":"public"})
Node.js
const result = await cotlet.call('vimeo', 'set_video_privacy', {"video_id":"video_8c41d2","privacy":"public"});
CLI
cotlet call vimeo set_video_privacy --data '{"video_id":"video_8c41d2","privacy":"public"}'

Example response

JSON

{
  "video_id": "912345611",
  "privacy": "unlisted",
  "embed": "anywhere",
  "updated": true
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.