Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://api.vimeo.com
/tokens
This method revokes the access token that the requesting app is currently using. The token must be of the OAuth 2 type.
DELETE /tokens
/me/categories/{category}
This method causes the authenticated user to stop following the specified category.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| category | path | required | string | The name of the category. |
DELETE /me/categories/{category}
/users/{user_id}/categories/{category}
This method causes the authenticated user to stop following the specified category.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| category | path | required | string | The name of the category. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/categories/{category}
/channels/{channel_id}/categories/{category}
This method removes a channel from the specified category. The authenticated user must be the owner of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| category | path | required | string | The name of the category. |
| channel_id | path | required | number | The ID of the channel. |
DELETE /channels/{channel_id}/categories/{category}
/channels/{channel_id}
This method deletes the specified channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
DELETE /channels/{channel_id}
/channels/{channel_id}/moderators
This method removes multiple moderators from the specified channel. The authenticated user must be the owner of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
{
"content": {
"application/vnd.vimeo.user+json": {
"schema": {
"$ref": "#/components/schemas/ChannelsModeratorsRemoveMultipleFromChannelRequest"
}
}
},
"required": true
}
DELETE /channels/{channel_id}/moderators
/channels/{channel_id}/moderators/{user_id}
This method removes a single moderator from the specified channel. The authenticated user must be the owner of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
| user_id | path | required | number | The ID of the user. |
DELETE /channels/{channel_id}/moderators/{user_id}
/channels/{channel_id}/privacy/users/{user_id}
This method prevents a single user from being able to access the specified private channel. The authenticated user must be the owner of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
| user_id | path | required | number | The ID of the user. |
DELETE /channels/{channel_id}/privacy/users/{user_id}
/me/channels/{channel_id}
This method unsubscribes the authenticated user from the specified channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
DELETE /me/channels/{channel_id}
/users/{user_id}/channels/{channel_id}
This method unsubscribes the authenticated user from the specified channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/channels/{channel_id}
/channels/{channel_id}/tags/{word}
This method removes a single tag from the specified channel. The authenticated user must be the owner of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
| word | path | required | string | The word to use as the tag. |
DELETE /channels/{channel_id}/tags/{word}
/channels/{channel_id}/videos
This method removes multiple videos from the specified channel. Include the videos by their URI as a JSON block in the body of the request using the **video_uri** field, like this: `[{ "video_uri": "/videos/1234" }, { "video_uri": "/videos/1235" }]`. The authenticated user must be a moderator of the channel. For more information on batch requests like this one, see [Using Common Formats and Parameters](https://developer.vimeo.com/api/common-formats#working-with-batch-requests).
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ChannelsVideosRemoveMultipleFromChannelRequest"
}
}
},
"required": true
}
DELETE /channels/{channel_id}/videos
/channels/{channel_id}/videos/{video_id}
This method removes a single video from the specified channel. The authenticated user must be a moderator of the channel.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| channel_id | path | required | number | The ID of the channel. |
| video_id | path | required | number | The ID of the video. |
DELETE /channels/{channel_id}/videos/{video_id}
/me/customlogos/{logo_id}
This method deletes the specified custom logo belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| logo_id | path | required | number | The ID of the custom logo. |
DELETE /me/customlogos/{logo_id}
/users/{user_id}/customlogos/{logo_id}
This method deletes the specified custom logo belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| logo_id | path | required | number | The ID of the custom logo. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/customlogos/{logo_id}
/videos/{video_id}/presets/{preset_id}
This method removes the specified embed preset from a video. The authenticated user must either be the owner of the video or a team user with the contributor or admin role.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| preset_id | path | required | number | The ID of the embed preset. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/presets/{preset_id}
/me/projects/{project_id}
This method deletes the specified folder and optionally also the videos that it contains. The authenticated user must be the owner of the folder.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| should_delete_clips | query | optional | boolean | Whether to delete all the videos in the folder along with the folder itself. |
DELETE /me/projects/{project_id}
/users/{user_id}/projects/{project_id}
This method deletes the specified folder and optionally also the videos that it contains. The authenticated user must be the owner of the folder.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| user_id | path | required | number | The ID of the user. |
| should_delete_clips | query | optional | boolean | Whether to delete all the videos in the folder along with the folder itself. |
DELETE /users/{user_id}/projects/{project_id}
/me/projects/{project_id}/items
This method removes all items from the specified folder.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| should_delete_items | query | optional | boolean | Whether to delete the items when removing them from the folder. |
| uris | query | required | string | A comma-separated list of video or event URIs to remove. |
DELETE /me/projects/{project_id}/items
/me/projects/{project_id}/videos
This method removes multiple videos from the specified folder. The authenticated user must be the owner of the folder.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| should_delete_clips | query | optional | boolean | Whether to delete the videos when removing them from the folder. |
| uris | query | required | string | A comma-separated list of the video URIs to remove. |
DELETE /me/projects/{project_id}/videos
/me/projects/{project_id}/videos/{video_id}
This method removes a single video from the specified folder. Please note that this doesn't delete the video itself.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| video_id | path | required | number | The ID of the video. |
DELETE /me/projects/{project_id}/videos/{video_id}
/users/{user_id}/projects/{project_id}/videos
This method removes multiple videos from the specified folder. The authenticated user must be the owner of the folder.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| user_id | path | required | number | The ID of the user. |
| should_delete_clips | query | optional | boolean | Whether to delete the videos when removing them from the folder. |
| uris | query | required | string | A comma-separated list of the video URIs to remove. |
DELETE /users/{user_id}/projects/{project_id}/videos
/users/{user_id}/projects/{project_id}/videos/{video_id}
This method removes a single video from the specified folder. Please note that this doesn't delete the video itself.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| project_id | path | required | number | The ID of the folder. |
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /users/{user_id}/projects/{project_id}/videos/{video_id}
/groups/{group_id}
This method deletes the specified group. The authenticated user must be the owner of the group.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| group_id | path | required | number | The ID of the group. |
DELETE /groups/{group_id}
/me/groups/{group_id}
This method removes the authenticated user from the specified group. The authenticated user can't be the owner of the group; assign a new owner through a PATCH request first.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| group_id | path | required | number | The ID of the group. |
DELETE /me/groups/{group_id}
/users/{user_id}/groups/{group_id}
This method removes the authenticated user from the specified group. The authenticated user can't be the owner of the group; assign a new owner through a PATCH request first.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| group_id | path | required | number | The ID of the group. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/groups/{group_id}
/groups/{group_id}/videos/{video_id}
This method removes a video from the specified group. The authenticated user must be the owner of the group.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| group_id | path | required | number | The ID of the group. |
| video_id | path | required | number | The ID of the video. |
DELETE /groups/{group_id}/videos/{video_id}
/me/likes/{video_id}
This method causes the authenticated user to unlike the specified video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
DELETE /me/likes/{video_id}
/users/{user_id}/likes/{video_id}
This method causes the authenticated user to unlike the specified video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /users/{user_id}/likes/{video_id}
/live_events
This method deletes multiple events belonging to the authenticated user.
{
"content": {
"application/vnd.vimeo.live.event.recurring+json": {
"schema": {
"$ref": "#/components/schemas/LiveEssentialsDeleteMultipleEventsRequest"
}
}
},
"required": true
}
DELETE /live_events
/live_events/{live_event_id}
This method deletes a single event belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
DELETE /live_events/{live_event_id}
/me/live_events
This method deletes multiple events belonging to the authenticated user.
{
"content": {
"application/vnd.vimeo.live.event.recurring+json": {
"schema": {
"$ref": "#/components/schemas/LiveEssentialsDeleteMultipleEventsRequest1"
}
}
},
"required": true
}
DELETE /me/live_events
/me/live_events/{live_event_id}
This method deletes a single event belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
DELETE /me/live_events/{live_event_id}
/users/{user_id}/live_events
This method deletes multiple events belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| user_id | path | required | number | The ID of the user. |
{
"content": {
"application/vnd.vimeo.live.event.recurring+json": {
"schema": {
"$ref": "#/components/schemas/LiveEssentialsDeleteMultipleEventsRequest2"
}
}
},
"required": true
}
DELETE /users/{user_id}/live_events
/users/{user_id}/live_events/{live_event_id}
This method deletes a single event belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/live_events/{live_event_id}
/destination/{destination_id}
This method deletes the specified event destination belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| destination_id | path | required | number | The ID of the event destination. |
DELETE /destination/{destination_id}
/users/{user_id}/live_events/{live_event_id}/ott_destination/{destination_id}
This method deletes an OTT channel as the destination of the specified event. The authenticated user must be the owner of the event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/live_events/{live_event_id}/ott_destination/{destination_id}
/live_events/{live_event_id}/pictures/{thumbnail_id}
This method deletes a thumbnail image for the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| thumbnail_id | path | required | number | The ID of the thumbnail. |
DELETE /live_events/{live_event_id}/pictures/{thumbnail_id}
/me/live_events/{live_event_id}/pictures/{thumbnail_id}
This method deletes a thumbnail image for the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| thumbnail_id | path | required | number | The ID of the thumbnail. |
DELETE /me/live_events/{live_event_id}/pictures/{thumbnail_id}
/users/{user_id}/live_events/{live_event_id}/pictures/{thumbnail_id}
This method deletes a thumbnail image for the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| thumbnail_id | path | required | number | The ID of the thumbnail. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/live_events/{live_event_id}/pictures/{thumbnail_id}
/live_events/{live_event_id}/videos
This method removes multiple videos from the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LiveEventVideosRemoveMultipleVideosRequest"
}
}
},
"required": false
}
DELETE /live_events/{live_event_id}/videos
/me/live_events/{live_event_id}/videos
This method removes multiple videos from the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LiveEventVideosRemoveMultipleRequest"
}
}
},
"required": false
}
DELETE /me/live_events/{live_event_id}/videos
/users/{user_id}/live_events/{live_event_id}/videos
This method removes multiple videos from the specified event.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| live_event_id | path | required | number | The ID of the event. |
| user_id | path | required | number | The ID of the user. |
{
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LiveEventVideosRemoveMultipleRequest1"
}
}
},
"required": false
}
DELETE /users/{user_id}/live_events/{live_event_id}/videos
/ondemand/pages/{ondemand_id}/backgrounds/{background_id}
This method deletes the specified background image on an On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| background_id | path | required | number | The ID of the background image. |
| ondemand_id | path | required | number | The ID of the On Demand page. |
DELETE /ondemand/pages/{ondemand_id}/backgrounds/{background_id}
/ondemand/pages/{ondemand_id}
This method deletes the specified On Demand page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| ondemand_id | path | required | number | The ID of the On Demand page. |
DELETE /ondemand/pages/{ondemand_id}
/ondemand/pages/{ondemand_id}/genres/{genre_id}
This method removes a genre association from the specified On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| genre_id | path | required | string | The ID of the genre. |
| ondemand_id | path | required | number | The ID of the On Demand page. |
DELETE /ondemand/pages/{ondemand_id}/genres/{genre_id}
/ondemand/pages/{ondemand_id}/promotions/{promotion_id}
This method deletes a promotion on the specified On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| ondemand_id | path | required | number | The ID of the On Demand page. |
| promotion_id | path | required | number | The ID of the promotion. |
DELETE /ondemand/pages/{ondemand_id}/promotions/{promotion_id}
/ondemand/pages/{ondemand_id}/regions
This method removes multiple regions from the specified On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| ondemand_id | path | required | number | The ID of the On Demand page. |
{
"content": {
"application/vnd.vimeo.ondemand.region+json": {
"schema": {
"$ref": "#/components/schemas/OnDemandRegionsRemoveMultipleRequest"
}
}
},
"required": false
}
DELETE /ondemand/pages/{ondemand_id}/regions
/ondemand/pages/{ondemand_id}/regions/{country}
This method removes a single region from the specified On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| country | path | required | string | The country code of the region to remove. |
| ondemand_id | path | required | number | The ID of the On Demand page. |
DELETE /ondemand/pages/{ondemand_id}/regions/{country}
/ondemand/pages/{ondemand_id}/videos/{video_id}
This method removes a video from the specified On Demand page. The authenticated user must be the owner of the page.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| ondemand_id | path | required | number | The ID of the On Demand page. |
| video_id | path | required | number | The ID of the video. |
DELETE /ondemand/pages/{ondemand_id}/videos/{video_id}
/me/payment_methods/{payment_method_id}
This method deletes the specified Vimeo payments service payment method.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| payment_method_id | path | required | string | The ID of the payment method. |
DELETE /me/payment_methods/{payment_method_id}
/me/portfolios/{portfolio_id}/videos/{video_id}
This method removes a video from the specified portfolio belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| portfolio_id | path | required | number | The ID of the portfolio. |
| video_id | path | required | number | The ID of the video. |
DELETE /me/portfolios/{portfolio_id}/videos/{video_id}
/users/{user_id}/portfolios/{portfolio_id}/videos/{video_id}
This method removes a video from the specified portfolio belonging to the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| portfolio_id | path | required | number | The ID of the portfolio. |
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /users/{user_id}/portfolios/{portfolio_id}/videos/{video_id}
/users/{user_id}/albums/{album_id}/logos/{logo_id}
This method deletes the specified custom logo from its showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
| logo_id | path | required | number | The ID of the custom logo. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/albums/{album_id}/logos/{logo_id}
/users/{user_id}/albums/{album_id}/custom_thumbnails/{thumbnail_id}
This method deletes the specified custom thumbnail from its showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
| thumbnail_id | path | required | number | The ID of the custom thumbnail. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/albums/{album_id}/custom_thumbnails/{thumbnail_id}
/me/albums/{album_id}
This method deletes the specified showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
DELETE /me/albums/{album_id}
/users/{user_id}/albums/{album_id}
This method deletes the specified showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/albums/{album_id}
/me/albums/{album_id}/videos/{video_id}
This method removes the specified video from its showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
| video_id | path | required | number | The ID of the video. |
DELETE /me/albums/{album_id}/videos/{video_id}
/users/{user_id}/albums/{album_id}/videos/{video_id}
This method removes the specified video from its showcase. The authenticated user must be the owner of the showcase.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| album_id | path | required | number | The ID of the showcase. |
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /users/{user_id}/albums/{album_id}/videos/{video_id}
/me/following/{follow_user_id}
This method causes the authenticated user to stop following another user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| follow_user_id | path | required | number | The ID of the user to unfollow. |
DELETE /me/following/{follow_user_id}
/users/{user_id}/following/{follow_user_id}
This method causes the authenticated user to stop following another user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| follow_user_id | path | required | number | The ID of the user to unfollow. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/following/{follow_user_id}
/me/pictures/{portraitset_id}
This method removes the specified portrait image from the authenticated user's Vimeo account.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| portraitset_id | path | required | number | The ID of the picture. |
DELETE /me/pictures/{portraitset_id}
/users/{user_id}/pictures/{portraitset_id}
This method removes the specified portrait image from the authenticated user's Vimeo account.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| portraitset_id | path | required | number | The ID of the picture. |
| user_id | path | required | number | The ID of the user. |
DELETE /users/{user_id}/pictures/{portraitset_id}
/me/watched/videos
This method deletes the entire watch history of the authenticated user.
DELETE /me/watched/videos
/me/watched/videos/{video_id}
This method deletes the specified video from the authenticated user's watch history.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
DELETE /me/watched/videos/{video_id}
/videos/{video_id}/animated_thumbsets/{picture_id}
This method deletes a set of animated thumbnails for the specified video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| picture_id | path | required | string | The UUID of the set of animated thumbnails. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/animated_thumbsets/{picture_id}
/videos/{video_id}/chapters/{chapter_id}
This method deletes the specified chapter from a video. The authenticated user must be the owner of the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| chapter_id | path | required | number | The ID of the chapter. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/chapters/{chapter_id}
/videos/{video_id}/chapters/{chapter_id}/pictures/{uid}
This method deletes the specified chapter thumbnail from a video. The authenticated user must be the owner of the video that the chapter belongs to. This method deletes both timecode-generated and custom-uploaded thumbnails.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| chapter_id | path | required | number | The ID of the chapter. |
| uid | path | required | string | The unique ID of the thumbnail. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/chapters/{chapter_id}/pictures/{uid}
/videos/{video_id}/credits/{credit_id}
This method deletes the specified user credit from a video. The authenticated user must be the creator of the credit or the credited user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| credit_id | path | required | number | The ID of the credit. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/credits/{credit_id}
/videos/{video_id}/privacy/domains/{domain}
This method removes the specified domain from a video's whitelist.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| domain | path | required | string | The domain name. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/privacy/domains/{domain}
/me/videos
This method deletes one or more videos belonging to the specified user. The authenticated user must have permission to delete the videos. Specify the videos to delete in a comma-separated list by URI using the **uris** query parameter.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| uris | query | required | string | A comma-separated list of the video URIs to delete. |
DELETE /me/videos
/users/{user_id}/videos
This method deletes one or more videos belonging to the specified user. The authenticated user must have permission to delete the videos. Specify the videos to delete in a comma-separated list by URI using the **uris** query parameter.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| user_id | path | required | number | The ID of the user. |
| uris | query | required | string | A comma-separated list of the video URIs to delete. |
DELETE /users/{user_id}/videos
/videos/{video_id}
This method deletes the specified video. The authenticated user must be the owner of the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}
/videos/{video_id}/fragments
This method deletes all fragments for the specified video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/fragments
/videos/{video_id}/tags/{word}
This method removes the specified tag from a video. The authenticated user must have edit access to the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
| word | path | required | string | The tag word. |
DELETE /videos/{video_id}/tags/{word}
/videos/{video_id}/texttracks/{texttrack_id}
This method deletes the specified text track from a video. The authenticated user must be the owner of the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| texttrack_id | path | required | number | The ID of the text track. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/texttracks/{texttrack_id}
/videos/{video_id}/pictures/{picture_id}
This method deletes the specified thumbnail image from a video. The authenticated user must have team permissions for the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| picture_id | path | required | number | The ID of the thumbnail. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/pictures/{picture_id}
/videos/{video_id}/privacy/users/{user_id}
This method prevents a user from being able to view the specified unlisted video. The authenticated user must be the owner of the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/privacy/users/{user_id}
/users/{user_id}/uploads/{upload_id}
This method completes the specified streaming upload of the authenticated user.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| upload_id | path | required | number | The ID of the streaming upload. |
| user_id | path | required | number | The ID of the user. |
| signature | query | required | string | The crypto signature of the completed upload. |
| video_file_id | query | required | number | The ID of the uploaded file. |
DELETE /users/{user_id}/uploads/{upload_id}
/videos/{video_id}/versions/{version_id}
This method deletes the specified version from a video. The authenticated user must be the owner of the video.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| version_id | path | required | number | The ID of the video version. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/versions/{version_id}
/videos/{video_id}/comments/{comment_id}
This method deletes the specified video comment. The authenticated user must be the owner of the comment.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| comment_id | path | required | number | The ID of the comment. |
| video_id | path | required | number | The ID of the video. |
DELETE /videos/{video_id}/comments/{comment_id}
/me/watchlater/{video_id}
This method removes the specified video from the authenticated user's Watch Later queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| video_id | path | required | number | The ID of the video. |
DELETE /me/watchlater/{video_id}
/users/{user_id}/watchlater/{video_id}
This method removes the specified video from the authenticated user's Watch Later queue.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| user_id | path | required | number | The ID of the user. |
| video_id | path | required | number | The ID of the video. |
DELETE /users/{user_id}/watchlater/{video_id}
AuthenticationExtrasConvertOAuth1ToOAuth2Request
{
"type": "object",
"required": [
"grant_type",
"token",
"token_secret"
],
"properties": {
"token": {
"type": "string",
"example": "58037c0078d5f54e15e638cc0dd882a570b13c50",
"description": "The OAuth 1 token."
},
"grant_type": {
"enum": [
"vimeo_oauth1"
],
"type": "string",
"description": "The grant type. The value of this field must be `vimeo_oauth1`."
},
"token_secret": {
"type": "string",
"example": "NTgwMzdjMDA3OGQ1ZjU0ZTE1ZTYzOGNjMGRkODgyYTU3MGIxM2M1MA==",
"description": "The OAuth 1 token secret."
}
}
}
AuthenticationExtrasExchangeOAuthCodeExchangeRequest
{
"type": "object",
"required": [
"code",
"grant_type",
"redirect_uri"
],
"properties": {
"code": {
"type": "string",
"example": "1234abcd",
"description": "The authorization code received from the authorization server."
},
"grant_type": {
"enum": [
"authorization_code"
],
"type": "string",
"description": "The grant type. The value of this field must be `authorization_code`."
},
"redirect_uri": {
"type": "string",
"example": "https://example.com",
"description": "The redirect URI. The value of this field must match the URI from `/oauth/authorize`."
}
}
}
AvailableUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
CategoriesChannelsListInCategoryResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/channel"
}
}
CategoriesGroupsGetAllGroupsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/group"
}
}
CategoriesUsersListFollowedCategories200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
}
}
CategoriesUsersListFollowedCategoriesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
}
}
CategoriesVideosGetAllVideoCategoriesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
}
}
CategoriesVideosListVideosInCategoryResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
CategoriesVideosSetVideoCategoriesRequest
{
"type": "object",
"required": [
"category"
],
"properties": {
"category": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the names of the desired categories."
}
}
}
ChannelsCategoriesAddChannelToMultipleCategoriesRequest
{
"type": "object",
"required": [
"channels"
],
"properties": {
"channels": {
"type": "array",
"items": {
"type": "string"
},
"description": "The array of category URIs to add."
}
}
}
ChannelsCategoriesGetBelongingCategoriesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
}
}
ChannelsEssentialsGetUserSubscriptions200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/channel"
}
}
ChannelsEssentialsGetUserSubscriptionsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/channel"
}
}
ChannelsModeratorsListByChannelResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
ChannelsModeratorsRemoveMultipleFromChannelRequest
{
"type": "object",
"required": [
"user_uri"
],
"properties": {
"user_uri": {
"type": "string",
"example": "/users/152184",
"description": "The URI of a user to remove as a moderator."
}
}
}
ChannelsModeratorsReplaceModeratorsRequest
{
"type": "object",
"required": [
"user_uri"
],
"properties": {
"user_uri": {
"type": "string",
"example": "/users/152184",
"description": "The URI of the user to add as a moderator."
}
}
}
ChannelsModeratorsReplaceModeratorsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
ChannelsPrivateChannelMembersGetAccessibleUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
ChannelsPrivateChannelMembersPermitUserAccessRequest
{
"type": "object",
"required": [
"users"
],
"properties": {
"users": {
"type": "array",
"items": {
"type": "string"
},
"description": "The array of either the user URIs or the user IDs to permit to access the private channel."
}
}
}
ChannelsPrivateChannelMembersPermitUserAccessResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
ChannelsSubscriptionsAndSubscribersListChannelFollowersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
ChannelsTagsAddMultipleTagsToChannelRequest
{
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the tag to assign."
}
}
}
}
ChannelsTagsAddMultipleTagsToChannelResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
}
}
ChannelsTagsGetAllChannelTagsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
}
}
ChannelsVideosAddMultipleToChannelRequest
{
"type": "object",
"required": [
"video_uri"
],
"properties": {
"video_uri": {
"type": "string",
"example": "/videos/258684937",
"description": "A member of an array representing the URIs of the videos to add. For each member in the array, use the format `{\"video_uri\":\"x\"}` where **x** is a video URI. For more information on batch requests like this, see [Using Common Formats and Parameters](https://developer.vimeo.com/api/common-formats#working-with-batch-requests)."
}
}
}
ChannelsVideosGetAccessibleChannelsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/channel"
}
}
ChannelsVideosListInChannelResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
ChannelsVideosRemoveMultipleFromChannelRequest
{
"type": "object",
"required": [
"video_uri"
],
"properties": {
"video_uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to remove."
}
}
}
ClientAuthRequest
{
"type": "object",
"required": [
"grant_type",
"scope"
],
"properties": {
"scope": {
"type": "string",
"example": "public",
"description": "A space-separated list of the authentication scopes to access. The default is `public`."
},
"grant_type": {
"enum": [
"client_credentials"
],
"type": "string",
"description": "The grant type. The value of this field must be `client_credentials`."
}
}
}
ClipTrimRequest
{
"type": "object",
"properties": {
"trim_end": {
"type": "string",
"example": "2.0",
"description": "The end position in seconds of the trim in the video."
},
"trim_start": {
"type": "string",
"example": "1.0",
"description": "The start position in seconds of the trim in the video."
}
}
}
CreateChannelRequest
{
"type": "object",
"required": [
"name",
"privacy"
],
"properties": {
"link": {
"type": "string",
"example": "staffpicks",
"description": "The link to access the channel. You can use a custom name in the URL in place of a numeric channel ID, as in `/channels/{url_custom}`."
},
"name": {
"type": "string",
"example": "Vimeo Staff Picks",
"description": "The name of the channel."
},
"privacy": {
"enum": [
"anybody",
"moderators",
"user"
],
"type": "string",
"description": "The privacy level of the channel.\n\nOption descriptions:\n * `anybody` - Anyone can access the channel.\n * `moderators` - Only moderators can access the channel.\n * `user` - Only moderators and designated users can access the channel.\n"
},
"description": {
"type": "string",
"example": "We really love videos, and these are the videos we really, really love.",
"description": "The description of the channel."
}
}
}
CreateChapterRequest
{
"type": "object",
"properties": {
"title": {
"type": "string",
"example": "Chapter 1",
"nullable": true,
"description": "The title of the chapter."
},
"timecode": {
"type": "number",
"example": 140,
"nullable": true,
"description": "The timecode of the chapter in seconds from the start of the video."
},
"thumbnail_uris": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of URIs of the thumbnails associated with the video chapter."
},
"active_thumbnail_uri": {
"type": "string",
"example": "/videos/12345678/chapters/12345/pictures/24kjh4h4g38175db9f59fae9f7g9ekhg",
"description": "The URI of the chapter's active thumbnail."
}
}
}
CreateCommentRequest
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"example": "I love this!",
"description": "The text of the comment."
}
}
}
CreateGroupRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Vimeo Weekend Challenge",
"description": "The name of the group."
},
"description": {
"type": "string",
"example": "Want to participate in our weekly challenges? Join the group to receive messages and new challenges!",
"description": "The description of the group."
}
}
}
CreateProjectRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Rough cuts",
"description": "The name of the folder."
},
"parent_folder_uri": {
"type": "string",
"example": "/users/12345/projects/6789",
"description": "The URI of the parent folder."
}
}
}
CreateShowcaseRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Vimeo Holiday Videos!",
"description": "The name of the showcase."
},
"sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"description": "The default sort order of the videos as they appear in the showcase.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the showcase, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the showcase, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the showcase.\n * `comments` - The videos appear according to their number of comments.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order with the newest first.\n * `oldest` - The videos appear in chronological order with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"theme": {
"enum": [
"dark",
"standard"
],
"type": "string",
"description": "The color theme of the showcase.\n\nOption descriptions:\n * `dark` - The showcase uses the dark theme.\n * `standard` - The showcase uses the standard theme.\n"
},
"layout": {
"enum": [
"grid",
"player"
],
"type": "string",
"description": "The type of layout for presenting the showcase.\n\nOption descriptions:\n * `grid` - The videos appear in a grid.\n * `player` - The videos appear in the player.\n"
},
"privacy": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"team",
"unlisted"
],
"type": "string",
"description": "The privacy level of the showcase.\n\nOption descriptions:\n * `anybody` - Anyone can access the showcase, either on Vimeo or through an embed.\n * `embed_only` - The showcase doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one can access the showcase, including the authenticated user.\n * `password` - Only those with the password can access the showcase.\n * `team` - Only members of the authenticated user's team can access the showcase.\n * `unlisted` - The showcase can't be accessed if the URL omits its unlisted hash.\n"
},
"hide_nav": {
"type": "boolean",
"example": true,
"description": "Whether to hide Vimeo navigation when displaying the showcase."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The showcase's password. This field is required only when **privacy** is `password`."
},
"brand_color": {
"type": "string",
"example": "ff66ee",
"description": "The hexadecimal code for the color of the player buttons and showcase controls."
},
"description": {
"type": "string",
"example": "Vimeo holiday videos!",
"description": "The description of the showcase."
},
"review_mode": {
"type": "boolean",
"example": true,
"description": "Whether showcase videos use the review mode URL."
},
"hide_upcoming": {
"type": "boolean",
"example": false,
"description": "Whether to include the upcoming event in the showcase."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether the showcase should be hidden from Vimeo when unlisted."
}
}
}
CreateVodRequest
{
"type": "object",
"required": [
"content_rating",
"description",
"name",
"type"
],
"properties": {
"buy": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in euros."
},
"GBP": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 2.99,
"description": "When **type** is `film`, the purchase price of the video in United States dollars. When **type** is `series`, the purchase price of the entire collection in United States dollars."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be purchased. This parameter is required when **rent.active** is `false`."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether people who buy the video can download it. To use this parameter, **type** must be `film`."
}
}
},
"link": {
"type": "string",
"example": "darbyforever",
"description": "The custom string to use in the Vimeo URL of the On Demand page."
},
"name": {
"type": "string",
"example": "Darby Forever",
"description": "The name of the On Demand page."
},
"rent": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in euros."
},
"GBP": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 0.99,
"description": "When **type** is `film`, the rental price of the video in United States dollars. When **type** is `series`, the rental price of the entire collection in United States dollars."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be rented. This parameter is required when **episodes.rent.active** is `true`."
},
"period": {
"enum": [
"1 week",
"1 year",
"24 hour",
"3 month",
"30 day",
"48 hour",
"6 month",
"72 hour"
],
"type": "string",
"description": "The rental period of the video.\n\nOption descriptions:\n * `1 week` - The video can be rented for a maximum of 1 week.\n * `1 year` - The video can be rented for a maximum of 1 year.\n * `24 hour` - The video can be rented for a maximum of 24 hours.\n * `3 month` - The video can be rented for a maximum of 3 months.\n * `30 day` - The video can be rented for a maximum of 30 days.\n * `48 hour` - The video can be rented for a maximum of 48 hours.\n * `6 month` - The video can be rented for a maximum of 6 months.\n * `72 hour` - The video can be rented for a maximum of 72 hours.\n"
}
}
},
"type": {
"enum": [
"film",
"series"
],
"type": "string",
"description": "The type of the On Demand page.\n\nOption descriptions:\n * `film` - The On Demand page is a film.\n * `series` - The On Demand page is a series.\n"
},
"episodes": {
"type": "object",
"properties": {
"buy": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 1.99,
"description": "The purchase price per episode in United States dollars. This parameter is required when **episodes.buy.active** is `true`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether episodes can be purchased."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether people who buy episodes can download them. To use this parameter, **type** must be `series`."
}
}
},
"rent": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 0.99,
"description": "The rental price per episode in United States dollars. This parameter is applicable only when **type** is `series`, and it's required when **episode.rent.active** is `true`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether episodes can be rented."
},
"period": {
"enum": [
"1 week",
"1 year",
"24 hour",
"3 month",
"30 day",
"48 hour",
"6 month",
"72 hour"
],
"type": "string",
"description": "The rental period of the episode.\n\nOption descriptions:\n * `1 week` - The episode can be rented for a maximum of 1 week.\n * `1 year` - The episode can be rented for a maximum of 1 year.\n * `24 hour` - The episode can be rented for a maximum of 24 hours.\n * `3 month` - The episode can be rented for a maximum of 3 months.\n * `30 day` - The episode can be rented for a maximum of 30 days.\n * `48 hour` - The episode can be rented for a maximum of 48 hours.\n * `6 month` - The episode can be rented for a maximum of 6 months.\n * `72 hour` - The episode can be rented for a maximum of 72 hours.\n"
}
}
}
}
},
"description": {
"type": "string",
"example": "DARBY FOREVER follows the fantasies of Darby, a shopgirl at \"Bobbins & Notions\".",
"description": "The description of the On Demand page."
},
"domain_link": {
"type": "string",
"example": "https://example.com",
"description": "The custom domain of the On Demand page."
},
"subscription": {
"type": "object",
"properties": {
"monthly": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 9.99,
"description": "The monthly subscription price in United States dollars. This parameter is required when **rent.active** and **buy.active** are `false`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether a monthly subscription is active. This parameter is required when **rent.active** and **buy.active** are `false`."
}
}
}
}
},
"content_rating": {
"enum": [
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "string",
"description": "The content rating of the video, given either as a comma-separated list or as a JSON array, depending on the request format.\n\nOption descriptions:\n * `drugs` - The video contains drug or alcohol use.\n * `language` - The video contains profanity or sexually suggestive content.\n * `nudity` - The video contains nudity.\n * `safe` - The video is suitable for all audiences.\n * `unrated` - The video hasn't been rated.\n * `violence` - The video contains violent or graphic content.\n"
},
"accepted_currencies": {
"enum": [
"AUD",
"CAD",
"CHF",
"DKK",
"EUR",
"GBP",
"JPY",
"KRW",
"NOK",
"PLN",
"SEK",
"USD"
],
"type": "string",
"description": "An array of accepted currencies.\n\nOption descriptions:\n * `AUD` - The currency is in Australian dollars.\n * `CAD` - The currency is in Canadian dollars.\n * `CHF` - The currency is in Swiss francs.\n * `DKK` - The currency is in Danish krone.\n * `EUR` - The currency is in euros.\n * `GBP` - The currency is in British pounds.\n * `JPY` - The currency is in Japanese yen.\n * `KRW` - The currency is in South Korean won.\n * `NOK` - The currency is in Norwegian krone.\n * `PLN` - The currency is in Polish zloty.\n * `SEK` - The currency is in Swedish krona.\n * `USD` - The currency is in United States dollars.\n"
}
}
}
CreateWebinarRequest
{
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"example": "Interviews Daily",
"description": "The title of the webinar."
},
"privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"password",
"team"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the webinar.\n\nOption descriptions:\n * `anybody` - Anyone can access the webinar. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - No one except the owner can access the webinar. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `team` - Only members of the authenticated user's team can access the webinar.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The initial embed privacy of the webinar.\n\nOption descriptions:\n * `private` - The webinar can't be embedded on any domain.\n * `public` - The webinar can be embedded on any domain.\n * `whitelist` - The webinar can be embedded on whitelisted domains only.\n"
}
},
"description": "The privacy settings of the webinar."
},
"password": {
"type": "string",
"example": "gogo",
"description": "The password when **privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the webinar event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the webinar is expected to be live.\n\nOption descriptions:\n * `single` - The webinar is live one time only.\n * `weekly` - The webinar is live on a weekly basis. _This field is deprecated._\n"
},
"end_time": {
"type": "string",
"example": "2019-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to end, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the webinar is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
}
},
"description": "Information about the time or times that the webinar is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in the automatically generated video titles for the webinar."
},
"folder_uri": {
"type": "number",
"example": 0,
"description": "The URI of the webinar's folder."
},
"description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the webinar."
},
"email_settings": {
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar. _This field is deprecated._"
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos_2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar. _This field is deprecated._"
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar. _This field is deprecated._"
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address. _This field is deprecated._"
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address. _This field is deprecated._"
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar. _This field is deprecated._"
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts. _This field is deprecated._"
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails. _This field is deprecated._"
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts. _This field is deprecated._"
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts. _This field is deprecated._"
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration. _This field is deprecated._"
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows. _This field is deprecated._"
}
},
"description": "The preferences for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy. _This field is deprecated._"
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar. _This field is deprecated._"
}
},
"description": "The settings for emails that are sent about the webinar. _This field is deprecated._"
}
}
}
EditChannelRequest
{
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "staffpicks",
"description": "The link to access the channel. You can use a custom name in the URL in place of a numeric channel ID, as in `/channels/{url_custom}`. Submitting `\"\"` for this field removes the link alias."
},
"name": {
"type": "string",
"example": "Vimeo Staff Picks",
"description": "The name of the channel."
},
"privacy": {
"enum": [
"anybody",
"moderators",
"users"
],
"type": "string",
"description": "The privacy level of the channel.\n\nOption descriptions:\n * `anybody` - Anyone can access the channel.\n * `moderators` - Only moderators can access the channel.\n * `users` - Only moderators and designated users can access the channel.\n"
},
"description": {
"type": "string",
"example": "We really love videos, and these are the videos we really, really love.",
"description": "The description of the channel."
}
}
}
EditChapterRequest
{
"type": "object",
"properties": {
"title": {
"type": "string",
"example": "Chapter 1",
"nullable": true,
"description": "The title of the chapter."
},
"timecode": {
"type": "number",
"example": 140,
"nullable": true,
"description": "The timecode of the chapter in seconds from the start of the video."
},
"active_thumbnail_uri": {
"type": "string",
"example": "/videos/12345678/chapters/12345/pictures/24kjh4h4g38175db9f59fae9f7g9ekhg",
"description": "The URI of the chapter's active thumbnail."
}
}
}
EditCommentRequest
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"example": "I love this!",
"description": "The new comment text."
}
}
}
EditPictureRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the picture is the authenticated user's active portrait."
}
}
}
EditProjectRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Rough cuts",
"description": "The name of the folder."
}
}
}
EditShowcaseRequest
{
"type": "object",
"properties": {
"url": {
"type": "string",
"example": "my-custom-url",
"nullable": true,
"description": "The custom Vimeo URL of the showcase."
},
"name": {
"type": "string",
"example": "Vimeo Holiday Videos!",
"description": "The name of the showcase."
},
"sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"description": "The default sort order of the videos as they appear in the showcase.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the showcase, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the showcase, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the showcase.\n * `comments` - The videos appear according to their number of comments.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order with the newest first.\n * `oldest` - The videos appear in chronological order with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"theme": {
"enum": [
"dark",
"standard"
],
"type": "string",
"description": "The color theme of the showcase.\n\nOption descriptions:\n * `dark` - The showcase uses the dark theme.\n * `standard` - The showcase uses the standard theme.\n"
},
"domain": {
"type": "string",
"example": "mycustomdomain.com",
"nullable": true,
"description": "The custom domain of the showcase."
},
"layout": {
"enum": [
"grid",
"player"
],
"type": "string",
"description": "The type of layout for presenting the showcase.\n\nOption descriptions:\n * `grid` - The videos appear in a grid.\n * `player` - The videos appear in the player.\n"
},
"privacy": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"team",
"unlisted"
],
"type": "string",
"description": "The privacy level of the showcase.\n\nOption descriptions:\n * `anybody` - Anyone can access the showcase, either on Vimeo or through an embed.\n * `embed_only` - The showcase doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one can access the showcase, including the authenticated user.\n * `password` - Only people with the password can access the showcase.\n * `team` - Only members of the authenticated user's team can access the showcase.\n * `unlisted` - The showcase can't be accessed if the URL omits its unlisted hash.\n"
},
"hide_nav": {
"type": "boolean",
"example": true,
"description": "Whether to hide Vimeo navigation when displaying the showcase."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The showcase's password. This field is required only when **privacy** is `password`."
},
"brand_color": {
"type": "string",
"example": "ff66ee",
"description": "The hexadecimal code for the color of the player buttons and showcase controls."
},
"description": {
"type": "string",
"example": "Vimeo holiday videos!",
"description": "The description of the showcase."
},
"review_mode": {
"type": "boolean",
"example": true,
"description": "Whether showcase videos use the review mode URL."
},
"hide_upcoming": {
"type": "boolean",
"example": false,
"description": "Whether to include the upcoming event in the showcase."
},
"use_custom_domain": {
"type": "boolean",
"example": true,
"description": "Whether the user has opted for a custom domain for their showcase."
}
}
}
EditUserRequest
{
"type": "object",
"properties": {
"bio": {
"type": "string",
"example": "This is where you will find videos and news updates from the staff",
"description": "The user's bio."
},
"link": {
"type": "string",
"example": "staff",
"description": "The user's custom Vimeo URL."
},
"name": {
"type": "string",
"example": "Vimeo Staff",
"description": "The user's display name."
},
"gender": {
"enum": [
"f",
"m",
"n",
"o"
],
"type": "string",
"description": "The authenticated user's gender.\n\nOption descriptions:\n * `f` - The user's preferred pronouns are she and her.\n * `m` - The user's preferred pronouns are he and him.\n * `n` - The user would rather not give preferred pronouns.\n * `o` - The user's preferred pronouns are they and them.\n"
},
"videos": {
"type": "object",
"properties": {
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether the user can add videos to showcases, channels, or groups by default."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"description": "Who can access the user's videos by default.\n\nOption descriptions:\n * `anybody` - Anyone can access the videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only the user's contacts can access the videos. _This field is deprecated._\n * `disable` - The videos are disabled. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end.\n * `nobody` - No one can access the videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the videos.\n * `unlisted` - The videos are unlisted.\n * `users` - Only other Vimeo members can access the videos. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"description": "The privacy for the user's embedded videos. The whitelist value enables you to define all valid embeddable domains. See our [Interacting with Videos](https://developer.vimeo.com/api/guides/videos/interact#set-off-site-privacy) guide for details on adding and removing domains.\n\nOption descriptions:\n * `private` - The videos can't be embedded on any domain.\n * `public` - The videos can be embedded on any domain.\n * `whitelist` - The videos can be embedded on the specified domains only.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"description": "Who can comment on the user's video uploads by default.\n\nOption descriptions:\n * `anybody` - Anyone can comment.\n * `contacts` - Only the user's contacts can comment.\n * `nobody` - No one can comment.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether the user can download videos. This value becomes the default download setting for all future videos that the user uploads."
}
}
}
}
},
"location": {
"type": "string",
"example": "New York City",
"description": "The user's location."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The default password for all future videos that this user uploads. To use this field, the **videos.privacy.view** field must be `password`."
},
"content_filter": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in the user's videos. Find the full list in the [/contentratings](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint. You must provide a comma-separated list if you're using a query string or an array if you're using JSON."
}
}
}
EditVideoRequest
{
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Celebrating 10 Years of Staff Picks",
"description": "The title of the video. This field can hold a maximum of 128 characters."
},
"embed": {
"type": "object",
"properties": {
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The UUID of the card."
},
"url": {
"type": "string",
"description": "The URL of the card."
},
"teaser": {
"type": "string",
"description": "The description of the card."
},
"headline": {
"type": "string",
"description": "The title of the card."
},
"timecode": {
"type": "number",
"description": "The playback timestamp, given in seconds, when the card appears."
},
"image_url": {
"type": "string",
"description": "The URL of the thumbnail for the card."
},
"display_time": {
"type": "number",
"description": "The number of seconds for which the card appears."
}
}
},
"description": "A collection of cards associated with the selected video."
},
"color": {
"type": "string",
"example": "#1ab7ea",
"description": "The main color of the embeddable player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embeddable player."
},
"custom": {
"type": "object",
"properties": {
"id": {
"type": "number",
"example": 462119,
"nullable": true,
"description": "The ID of the custom logo that will show on the emeddable player."
},
"link": {
"type": "string",
"example": "https://example.com",
"nullable": true,
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the active custom logo on the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo is always visible on the embeddable player (`true`) or whether the logo appears and disappears with the rest of the UI (`false`)."
}
}
}
}
},
"title": {
"type": "object",
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the video title in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the video title.\n * `show` - Show the video title.\n * `user` - Enable the user to decide.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner information in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the owner info.\n * `show` - Show the owner info.\n * `user` - Enable the user to decide.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner portrait in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the portrait.\n * `show` - Show the portrait.\n * `user` - Enable the user to decide.\n"
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether to show the volume selector on the embeddable player."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"buttons": {
"type": "object",
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether to show the `HD` button on the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether to show the `like` button on the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether to show the `embed` button on the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether to show the `share` button on the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether to show the `scaling` button on the embeddable player in fullscreen mode."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether to show the `fullscreen` button on the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether to show the `watch later` button on the embeddable player."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether to show the playbar on the embeddable player."
},
"chapters": {
"type": "boolean",
"example": true,
"description": "Whether chapters are enabled in the embeddable player."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"end_screen": {
"type": "object",
"properties": {
"type": {
"enum": [
"empty",
"loop",
"share",
"thumbnail"
],
"type": "string",
"description": "The end screen type.\n\nOption descriptions:\n * `empty` - The end screen is empty.\n * `loop` - The end screen loops the video playback.\n * `share` - The end screen includes sharing options.\n * `thumbnail` - The end screen includes the thumbnail of the video.\n"
}
}
},
"transcript": {
"type": "boolean",
"example": true,
"description": "Whether the transcript controls appear in the embeddable player."
},
"play_button": {
"type": "object",
"properties": {
"position": {
"enum": [
"auto",
"bottom",
"center"
],
"type": "string",
"description": "The position of the play button within the embeddable player.\n\nOption descriptions:\n * `auto` - Use Vimeo's default positioning for the play button.\n * `bottom` - The play button is positioned at the bottom of the player, except when in tiny mode.\n * `center` - The play button is positioned in the center of the player.\n"
}
},
"description": "An object representing the play button's settings."
},
"audio_tracks": {
"type": "boolean",
"example": true,
"description": "Whether multiple audio tracks can appear in the embeddable player."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"quality_selector": {
"type": "boolean",
"example": true,
"description": "Whether to show the quality selector in the embeddable player."
}
}
},
"locale": {
"type": "string",
"example": "en-US",
"description": "The video's default language. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
},
"license": {
"enum": [
"by",
"by-nc",
"by-nc-nd",
"by-nc-sa",
"by-nd",
"by-sa",
"cc0"
],
"type": "string",
"description": "The Creative Commons license under which the video is offered.\n\nOption descriptions:\n * `by` - The video is offered under CC BY, or the attibution-only license.\n * `by-nc` - The video is offered under CC BY-NC, or the Attribution-NonCommercial license.\n * `by-nc-nd` - The video is offered under CC BY-NC-ND, or the Attribution-NonCommercian-NoDerivs license.\n * `by-nc-sa` - The video is offered under CC BY-NC-SA, or the Attribution-NonCommercial-ShareAlike licence.\n * `by-nd` - The video is offered under CC BY-ND, or the Attribution-NoDerivs license.\n * `by-sa` - The video is offered under CC BY-SA, or the Attribution-ShareAlike license.\n * `cc0` - The video is offered under CC0, or public domain, videos.\n"
},
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether a user can add the video to a showcase, channel, or group."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"description": "The video's privacy setting. When this value is `users`, `application/json` is the only valid content type. Also, some privacy settings are unavailable to Vimeo Free members; for more information, see our [Help Center](https://vimeo.zendesk.com/hc/en-us/articles/224817847).\n\nOption descriptions:\n * `anybody` - Anyone can access the video. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only those who follow the owner on Vimeo can access the video. _This field is deprecated._\n * `disable` - The video is embeddable, but it's hidden on Vimeo and can't be played. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end. _This field is deprecated._\n * `nobody` - No one except the owner can access the video. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the video.\n * `unlisted` - Only those with the private link can access the video.\n * `users` - Only Vimeo members can access the video. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"description": "The video's embed setting. Specify the `whitelist` value to restrict embedding to a specific set of domains. For more information, see our [Interacting with Videos](https://developer.vimeo.com/api/guides/videos/interact#set-off-site-privacy) guide.\n\nOption descriptions:\n * `private` - The video can't be embedded.\n * `public` - The video can be embedded.\n * `whitelist` - The video can be embedded on the specified domains only.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"description": "The privacy level required to comment on the video.\n\nOption descriptions:\n * `anybody` - Anyone can comment on the video.\n * `contacts` - Only the owner's contacts can comment on the video.\n * `nobody` - No one can comment on the video.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether a user can download the video. This field isn't available to Vimeo Free members."
}
}
},
"spatial": {
"type": "object",
"properties": {
"projection": {
"enum": [
"cubical",
"cylindrical",
"dome",
"equirectangular",
"pyramid"
],
"type": "string",
"description": "The 360 spatial projection.\n\nOption descriptions:\n * `cubical` - Use cubical projection.\n * `cylindrical` - Use cylindrical projection.\n * `dome` - Use dome projection.\n * `equirectangular` - Use equirectangular projection.\n * `pyramid` - Use pyramid projection.\n"
},
"field_of_view": {
"type": "number",
"example": 50,
"description": "The 360 field of view. This value must be between 30 and 90. The default is 50."
},
"stereo_format": {
"enum": [
"left-right",
"mono",
"top-bottom"
],
"type": "string",
"description": "The 360 spatial stereo format.\n\nOption descriptions:\n * `left-right` - Use left-right stereo.\n * `mono` - Use monaural audio.\n * `top-bottom` - Use top-bottom stereo.\n"
},
"director_timeline": {
"type": "array",
"items": {
"type": "object",
"required": [
"pitch",
"time_code",
"yaw"
],
"properties": {
"yaw": {
"type": "number",
"example": 125,
"description": "The 360 director timeline yaw. This value must be between 0 and 360, and you must specify it only when **spatial.director_timeline** is defined."
},
"roll": {
"type": "number",
"description": "The 360 director timeline roll."
},
"pitch": {
"type": "number",
"example": 70,
"description": "The 360 director timeline pitch. This value must be between −90 and 90, and you must specify it only when **spatial.director_timeline** is defined."
},
"time_code": {
"type": "number",
"example": 5,
"description": "The 360 director timeline time code. This paramater is required only when **spatial.director_timeline** is defined."
}
}
},
"description": "An array representing the 360 director timeline."
}
}
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The password. When you set **privacy.view** to `password`, you must provide the password as an additional parameter. This field can hold a maximum of 32 characters."
},
"custom_url": {
"type": "string",
"example": "puppies",
"description": "The custom link of the video. This link doesn't include the base URL and the username or user ID of the video's owner."
},
"description": {
"type": "string",
"example": "A celebration of 10 years of Staff Picks.",
"description": "The description of the video. This field can hold a maximum of 5000 characters."
},
"review_page": {
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to enable video review."
}
}
},
"embed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "The complete list of domains the video can be embedded on. This field overwrites existing domains and requires that **privacy_embed** have the value `whitelist`."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this video. For a full list of values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether to hide the video from everyone except the video's owner. When the value is `true`, unlisted video links work only for the video's owner."
},
"embed_domains_add": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of domains intended to be added to an existing set of domains. This field requires that **privacy_embed** have the value `whitelist`."
},
"embed_domains_delete": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of domains intended to be removed from an existing set of domains. This field requires that **privacy_embed** have the value `whitelist`."
}
}
}
EditVodRequest
{
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "darbyforever",
"description": "The custom string to use in the Vimeo URL of the On Demand page."
},
"publish": {
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to publish the On Demand page."
}
}
},
"preorder": {
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to enable preorders on the On Demand page."
},
"publish_time": {
"type": "string",
"example": "2017-05-16T15:05:43+00:00",
"description": "The time in ISO 8601 format when the On Demand page will be published. This parameter is required when **preorder.active** is `true`."
}
}
},
"publish_when_ready": {
"type": "boolean",
"example": true,
"description": "Whether to publish the On Demand page automatically after all videos have finished transcoding."
}
}
}
EmbedPresetsCustomLogosListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
EmbedPresetsCustomLogosListUserLogosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
EmbedPresetsEssentialsCreateEmbedPresetRequest
{
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "New preset",
"description": "The name of the embed preset."
},
"embed": {
"type": "object",
"properties": {
"color": {
"type": "string",
"example": "#1ab7ea",
"description": "The main color of the embeddable player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embeddable player."
},
"custom": {
"type": "object",
"properties": {
"id": {
"type": "number",
"example": 462119,
"nullable": true,
"description": "The ID of the custom logo that appears on the embeddable player."
},
"link": {
"type": "string",
"example": "https://example.com",
"nullable": true,
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the active custom logo on the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo is always visible on the embeddable player (`true`) or whether the logo appears and disappears with the rest of the UI (`false`)."
}
}
}
}
},
"title": {
"type": "object",
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the video title in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the video title.\n * `show` - Show the video title.\n * `user` - Enable the user to decide.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner information in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the owner info.\n * `show` - Show the owner info.\n * `user` - Enable the user to decide.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner portrait in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the portrait.\n * `show` - Show the portrait.\n * `user` - Enable the user to decide.\n"
}
}
},
"colors": {
"type": "object",
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The hexadecimal color code of the first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The hexadecimal color code of the second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The hexadecimal color code of the fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The hexadecimal color code of the third player color, which controls the color of text and icons."
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether to show the volume selector on the embeddable player."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"buttons": {
"type": "object",
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether to show the `HD` button on the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether to show the `like` button on the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether to show the `embed` button on the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether to show the `share` button on the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether to show the `scaling` button on the embeddable player in fullscreen mode."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether to show the `fullscreen` button on the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether to show the `watch later` button on the embeddable player."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether to show the playbar on the embeddable player."
},
"chapters": {
"type": "boolean",
"example": true,
"description": "Whether chapters are enabled in the embeddable player."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"transcript": {
"type": "boolean",
"example": true,
"description": "Whether the transcript controls appear in the embeddable player."
},
"play_button": {
"type": "object",
"properties": {
"position": {
"enum": [
"auto",
"bottom",
"center"
],
"type": "string",
"description": "The position of the play button within the embeddable player.\n\nOption descriptions:\n * `auto` - Use Vimeo's default positioning for the play button.\n * `bottom` - The play button is positioned at the bottom of the player, except when in tiny mode.\n * `center` - The play button is positioned in the center of the player.\n"
}
},
"description": "An object representing the play button's settings."
},
"audio_tracks": {
"type": "boolean",
"example": true,
"description": "Whether multiple audio tracks can appear in the embeddable player."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"quality_selector": {
"type": "boolean",
"example": true,
"description": "Whether to show the quality selector in the embeddable player."
}
}
}
}
}
EmbedPresetsEssentialsCreatePresetRequest
{
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "New preset",
"description": "The name of the embed preset."
},
"embed": {
"type": "object",
"properties": {
"color": {
"type": "string",
"example": "#1ab7ea",
"description": "The main color of the embeddable player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embeddable player."
},
"custom": {
"type": "object",
"properties": {
"id": {
"type": "number",
"example": 462119,
"nullable": true,
"description": "The ID of the custom logo that appears on the embeddable player."
},
"link": {
"type": "string",
"example": "https://example.com",
"nullable": true,
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the active custom logo on the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo is always visible on the embeddable player (`true`) or whether the logo appears and disappears with the rest of the UI (`false`)."
}
}
}
}
},
"title": {
"type": "object",
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the video title in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the video title.\n * `show` - Show the video title.\n * `user` - Enable the user to decide.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner information in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the owner info.\n * `show` - Show the owner info.\n * `user` - Enable the user to decide.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner portrait in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the portrait.\n * `show` - Show the portrait.\n * `user` - Enable the user to decide.\n"
}
}
},
"colors": {
"type": "object",
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The hexadecimal color code of the first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The hexadecimal color code of the second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The hexadecimal color code of the fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The hexadecimal color code of the third player color, which controls the color of text and icons."
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether to show the volume selector on the embeddable player."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"buttons": {
"type": "object",
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether to show the `HD` button on the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether to show the `like` button on the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether to show the `embed` button on the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether to show the `share` button on the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether to show the `scaling` button on the embeddable player in fullscreen mode."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether to show the `fullscreen` button on the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether to show the `watch later` button on the embeddable player."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether to show the playbar on the embeddable player."
},
"chapters": {
"type": "boolean",
"example": true,
"description": "Whether chapters are enabled in the embeddable player."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"transcript": {
"type": "boolean",
"example": true,
"description": "Whether the transcript controls appear in the embeddable player."
},
"play_button": {
"type": "object",
"properties": {
"position": {
"enum": [
"auto",
"bottom",
"center"
],
"type": "string",
"description": "The position of the play button within the embeddable player.\n\nOption descriptions:\n * `auto` - Use Vimeo's default positioning for the play button.\n * `bottom` - The play button is positioned at the bottom of the player, except when in tiny mode.\n * `center` - The play button is positioned in the center of the player.\n"
}
},
"description": "An object representing the play button's settings."
},
"audio_tracks": {
"type": "boolean",
"example": true,
"description": "Whether multiple audio tracks can appear in the embeddable player."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"quality_selector": {
"type": "boolean",
"example": true,
"description": "Whether to show the quality selector in the embeddable player."
}
}
}
}
}
EmbedPresetsEssentialsEditPresetRequest
{
"type": "object",
"properties": {
"outro": {
"enum": [
"nothing"
],
"type": "string",
"description": "What to do with the outro.\n\nOption descriptions:\n * `nothing` - Disable the outro.\n"
}
}
}
EmbedPresetsEssentialsEditPresetRequest1
{
"type": "object",
"properties": {
"outro": {
"enum": [
"nothing"
],
"type": "string",
"description": "What to do with the outro.\n\nOption descriptions:\n * `nothing` - Disable the outro.\n"
}
}
}
EmbedPresetsEssentialsGetAllUserCreatedEmbedPresetsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/preset"
}
}
EmbedPresetsEssentialsGetUserEmbedPresetsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/preset"
}
}
EmbedPresetsVideosGetPresetVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
EmbedPresetsVideosGetSpecificPresetVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
FoldersEssentialsCreateFolderRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Rough cuts",
"description": "The name of the folder."
},
"parent_folder_uri": {
"type": "string",
"example": "/users/12345/projects/6789",
"description": "The URI of the parent folder."
}
}
}
FoldersEssentialsEditFolderRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Rough cuts",
"description": "The name of the folder."
}
}
}
FoldersEssentialsGetAllUserFoldersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/project"
}
}
FoldersVideosGetAllFolderVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
FoldersVideosGetVideosInFolderResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
FollowUsersRequest
{
"type": "object",
"required": [
"users"
],
"properties": {
"users": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of user IDs for the authenticated user to follow."
}
}
}
GetAppearancesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
GetCategoriesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
}
}
GetChannelsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/channel"
}
}
GetChaptersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/chapter"
}
}
GetCommentsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/comment"
}
}
GetFeedResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/activity-3-1"
}
}
GetFollowersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
GetGroupsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/group"
}
}
GetLanguagesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/language"
}
}
GetLikesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
GetPicturesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
GetPortfoliosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/portfolio"
}
}
GetProjectsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/project"
}
}
GetRegionsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-region"
}
}
GetShowcasesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/album"
}
}
GetTranscriptResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/segment"
}
}
GetVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
GroupsUsersGetGroupUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
GroupsUsersGetUserGroupsListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/group"
}
}
GroupsUsersGetUserGroupsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/group"
}
}
GroupsVideosGetAllGroupVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
LikesEssentialsGetAllUserLikesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
LikesEssentialsGetUserLikedVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
LikesEssentialsGetUserLikesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
LikesEssentialsGetUsersWhoLikedVideoResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
LiveEmbedPrivacyEmbedEventOnDomainsRequest
{
"type": "object",
"properties": {
"allowed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the domains on which the embedded event can appear."
}
}
}
LiveEmbedPrivacyEmbedEventOnDomainsRequest1
{
"type": "object",
"properties": {
"allowed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the domains on which the embedded event can appear."
}
}
}
LiveEmbedPrivacyEmbedEventOnDomainsRequest2
{
"type": "object",
"properties": {
"allowed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the domains on which the embedded event can appear."
}
}
}
LiveEmbedPrivacyGetWhitelistDomains200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/domain"
}
}
LiveEmbedPrivacyGetWhitelistDomainsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/domain"
}
}
LiveEssentialsCreateEventForUserRequest
{
"type": "object",
"required": [
"title"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether to show the latest archived video in the embed player when off-air."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"folder_uri": {
"type": "string",
"example": "/users/67890/projects/12345",
"description": "The URI of the event's folder."
},
"low_latency": {
"type": "boolean",
"description": "Whether the event has low-latency streaming enabled."
},
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"rtmp_preview": {
"type": "boolean",
"description": "Whether the event has RTMP preview enabled."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"allow_share_link": {
"type": "boolean",
"description": "Whether the share link is usable."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEssentialsCreateEventRequest
{
"type": "object",
"required": [
"title"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether to show the latest archived video in the embed player when off-air."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"folder_uri": {
"type": "string",
"example": "/users/67890/projects/12345",
"description": "The URI of the event's folder."
},
"low_latency": {
"type": "boolean",
"description": "Whether the event has low-latency streaming enabled."
},
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"rtmp_preview": {
"type": "boolean",
"description": "Whether the event has RTMP preview enabled."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"allow_share_link": {
"type": "boolean",
"description": "Whether the share link is usable."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEssentialsCreateLiveEventRequest
{
"type": "object",
"required": [
"title"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether to show the latest archived video in the embed player when off-air."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"folder_uri": {
"type": "string",
"example": "/users/67890/projects/12345",
"description": "The URI of the event's folder."
},
"low_latency": {
"type": "boolean",
"description": "Whether the event has low-latency streaming enabled."
},
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"rtmp_preview": {
"type": "boolean",
"description": "Whether the event has RTMP preview enabled."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"allow_share_link": {
"type": "boolean",
"description": "Whether the share link is usable."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEssentialsDeleteMultipleEventsRequest
{
"type": "object",
"required": [
"password"
],
"properties": {
"password": {
"type": "string",
"example": "hunter1",
"description": "The user’s password."
}
}
}
LiveEssentialsDeleteMultipleEventsRequest1
{
"type": "object",
"required": [
"password"
],
"properties": {
"password": {
"type": "string",
"example": "hunter1",
"description": "The user’s password."
}
}
}
LiveEssentialsDeleteMultipleEventsRequest2
{
"type": "object",
"required": [
"password"
],
"properties": {
"password": {
"type": "string",
"example": "hunter1",
"description": "The user’s password."
}
}
}
LiveEssentialsGetAllUserLiveEventsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event"
}
}
LiveEssentialsGetUserLiveEvents200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event"
}
}
LiveEssentialsGetUserLiveEventsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event"
}
}
LiveEssentialsUpdateEventBelongingToAuthenticatedUserRequest
{
"type": "object",
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": false,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"auto_cc_keywords": {
"type": "string",
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEssentialsUpdateEventBelongingToAuthenticatedUserRequest1
{
"type": "object",
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": false,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"auto_cc_keywords": {
"type": "string",
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEssentialsUpdateEventBelongingToAuthenticatedUserRequest2
{
"type": "object",
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"embed": {
"type": "object",
"properties": {
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the playlist should start from the beginning again after reaching the end of the last video."
},
"color": {
"type": "string",
"example": "#00adef",
"description": "The hexadecimal color code for the main color of the embed player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embed player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo on the embed player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether to show the custom logo persistently (`true`) or hide it with the rest of the UI (`false`)."
}
}
}
}
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether playback starts automatically on load."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether to show the playlist controls on the embed player."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether to show the event schedule on the embed player."
},
"use_color": {
"type": "boolean",
"example": true,
"description": "Whether the embed player should use (`true`) or ignore (`false`) the **embed.color** value."
}
},
"description": "The embed settings of the event and the videos generated by streaming to this event."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. If **automatically_title_stream** is `true`, this value is the base title for videos created by streaming to this event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the event is expected to be live.\n\nOption descriptions:\n * `single` - The event is live one time only.\n * `weekly` - The event is live on a weekly basis.\n"
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the event is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the event is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`."
}
},
"description": "Information about the time or times that the event is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in automatically generated video titles."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display the live chat client on the Vimeo event page."
},
"stream_embed": {
"type": "object",
"properties": {
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The embed permission level for the event.\n\nOption descriptions:\n * `private` - Only the user can embed the event.\n * `public` - Anyone can embed the event.\n * `whitelist` - Only those on the whitelist can embed the event.\n"
}
}
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video to be streamed to the event. This parameter is required when **automatically_title_stream** is `false`."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos of the event appear within the event's playlist.\n\nOption descriptions:\n * `added_first` - The most recently added videos appear first.\n * `added_last` - The most recently added videos appear last.\n * `alphabetical` - The videos appear in alphabetical order.\n * `arranged` - The videos appear in the order in which the user has arranged them.\n * `comments` - The videos appear in order of number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear in order of number of likes.\n * `newest` - The newest videos appear first.\n * `oldest` - The oldest videos appear first.\n * `plays` - The videos appear in order of number of plays.\n"
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this event. To return the list of all possible content rating values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"stream_privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the videos generated by streaming to the event as well as the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the event. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The event doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one except the owner can access the event. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `unlisted` - Only those with the private link can access the event.\n"
}
},
"description": "The privacy settings of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": false,
"description": "Whether automated closed captions are enabled for the event."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"description": "The password when **stream_privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the event."
},
"auto_cc_keywords": {
"type": "string",
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the next video to be streamed to the event."
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "Whether the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "object",
"properties": {
"is_qna_moderated": {
"type": "boolean",
"example": true,
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"example": true,
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
},
"description": "The settings for the interaction tools."
}
}
}
LiveEventActivationCreateRtmpLinksRequest
{
"type": "object",
"properties": {
"cloud_composing_streaming": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer. _This field is deprecated._"
},
"streaming_start_requested": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer."
}
}
}
LiveEventActivationCreateRtmpLinksRequest1
{
"type": "object",
"properties": {
"cloud_composing_streaming": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer. _This field is deprecated._"
},
"streaming_start_requested": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer."
}
}
}
LiveEventActivationCreateRtmpLinksRequest2
{
"type": "object",
"properties": {
"cloud_composing_streaming": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer. _This field is deprecated._"
},
"streaming_start_requested": {
"type": "boolean",
"example": true,
"description": "Whether the stream activates from the cloud composer."
}
}
}
LiveEventAutomatedClosedCaptionsEditPreferenceForEventRequest
{
"type": "object",
"required": [
"auto_cc_enabled"
],
"properties": {
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
}
}
}
LiveEventAutomatedClosedCaptionsEditPreferenceForEventRequest1
{
"type": "object",
"required": [
"auto_cc_enabled"
],
"properties": {
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
}
}
}
LiveEventAutomatedClosedCaptionsEditPreferenceRequest
{
"type": "object",
"required": [
"auto_cc_enabled"
],
"properties": {
"auto_cc_lang": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"description": "The language in which the automated closed captions appear.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether automated closed captions are enabled for the event."
},
"auto_cc_keywords": {
"type": "string",
"example": "commonly-used words,phrases,technical terms",
"description": "A comma-separated list of keywords that improve the quality of the automated closed captions."
}
}
}
LiveEventDestinationsCreateDestinationRequest
{
"type": "object",
"required": [
"display_name",
"service_name",
"type"
],
"properties": {
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"description": "The privacy setting of the destination. Be sure to choose a value that corresponds to your service.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled for simulcasting."
},
"stream_key": {
"type": "string",
"example": "da056692-ba63-4749-a6eb-a476a22b3acd",
"description": "The RTMP stream key."
},
"stream_url": {
"type": "string",
"example": "rtmp://mycooldomain.com/live",
"description": "The RTMP URL for receiving the video stream."
},
"display_name": {
"type": "string",
"example": "My channel",
"description": "The title to display for the simulcast."
},
"scheduled_at": {
"type": "number",
"example": 1625754461,
"description": "The time in Unix timestamp format when live streaming is scheduled to start."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "youtube",
"description": "The service to simulcast to.\n\nOption descriptions:\n * `custom_rtmp` - Simulcast to a custom service.\n * `facebook` - Simulcast to Facebook Live.\n * `linkedin` - Simulcast to LinkedIn Live.\n * `youtube` - Simulcast to YouTube Live.\n"
},
"provider_video_id": {
"type": "string",
"example": "6817807391346708000",
"nullable": true,
"description": "The ID of the scheduled video."
},
"provider_destination_id": {
"type": "string",
"example": "bda55c6b3ba4",
"description": "The ID of the destination on the specified service, such as the YouTube channel ID or the Facebook page ID."
}
}
}
LiveEventDestinationsCreateEventDestinationRequest
{
"type": "object",
"required": [
"display_name",
"service_name",
"type"
],
"properties": {
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"description": "The privacy setting of the destination. Be sure to choose a value that corresponds to your service.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled for simulcasting."
},
"stream_key": {
"type": "string",
"example": "da056692-ba63-4749-a6eb-a476a22b3acd",
"description": "The RTMP stream key."
},
"stream_url": {
"type": "string",
"example": "rtmp://mycooldomain.com/live",
"description": "The RTMP URL for receiving the video stream."
},
"display_name": {
"type": "string",
"example": "My channel",
"description": "The title to display for the simulcast."
},
"scheduled_at": {
"type": "number",
"example": 1625754461,
"description": "The time in Unix timestamp format when live streaming is scheduled to start."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "youtube",
"description": "The service to simulcast to.\n\nOption descriptions:\n * `custom_rtmp` - Simulcast to a custom service.\n * `facebook` - Simulcast to Facebook Live.\n * `linkedin` - Simulcast to LinkedIn Live.\n * `youtube` - Simulcast to YouTube Live.\n"
},
"provider_video_id": {
"type": "string",
"example": "6817807391346708000",
"nullable": true,
"description": "The ID of the scheduled video."
},
"provider_destination_id": {
"type": "string",
"example": "bda55c6b3ba4",
"description": "The ID of the destination on the specified service, such as the YouTube channel ID or the Facebook page ID."
}
}
}
LiveEventDestinationsCreateOneTimeLiveEventDestinationRequest
{
"type": "object",
"required": [
"display_name",
"service_name",
"type"
],
"properties": {
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"description": "The privacy setting of the destination. Be sure to choose a value that corresponds to your service.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled for simulcasting."
},
"stream_key": {
"type": "string",
"example": "da056692-ba63-4749-a6eb-a476a22b3acd",
"description": "The RTMP stream key."
},
"stream_url": {
"type": "string",
"example": "rtmp://mycooldomain.com/live",
"description": "The RTMP URL for receiving the video stream."
},
"display_name": {
"type": "string",
"example": "My channel",
"description": "The title to display for the simulcast."
},
"scheduled_at": {
"type": "number",
"example": 1625754461,
"description": "The time in Unix timestamp format when live streaming is scheduled to start."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "youtube",
"description": "The service to simulcast to.\n\nOption descriptions:\n * `custom_rtmp` - Simulcast to a custom service.\n * `facebook` - Simulcast to Facebook Live.\n * `linkedin` - Simulcast to LinkedIn Live.\n * `youtube` - Simulcast to YouTube Live.\n"
},
"provider_video_id": {
"type": "string",
"example": "6817807391346708000",
"nullable": true,
"description": "The ID of the scheduled video."
},
"provider_destination_id": {
"type": "string",
"example": "bda55c6b3ba4",
"description": "The ID of the destination on the specified service, such as the YouTube channel ID or the Facebook page ID."
}
}
}
LiveEventDestinationsCreateOneTimeLiveEventDestinationRequest1
{
"type": "object",
"required": [
"display_name",
"service_name",
"type"
],
"properties": {
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"description": "The privacy setting of the destination. Be sure to choose a value that corresponds to your service.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled for simulcasting."
},
"stream_key": {
"type": "string",
"example": "da056692-ba63-4749-a6eb-a476a22b3acd",
"description": "The RTMP stream key."
},
"stream_url": {
"type": "string",
"example": "rtmp://mycooldomain.com/live",
"description": "The RTMP URL for receiving the video stream."
},
"display_name": {
"type": "string",
"example": "My channel",
"description": "The title to display for the simulcast."
},
"scheduled_at": {
"type": "number",
"example": 1625754461,
"description": "The time in Unix timestamp format when live streaming is scheduled to start."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "youtube",
"description": "The service to simulcast to.\n\nOption descriptions:\n * `custom_rtmp` - Simulcast to a custom service.\n * `facebook` - Simulcast to Facebook Live.\n * `linkedin` - Simulcast to LinkedIn Live.\n * `youtube` - Simulcast to YouTube Live.\n"
},
"provider_video_id": {
"type": "string",
"example": "6817807391346708000",
"nullable": true,
"description": "The ID of the scheduled video."
},
"provider_destination_id": {
"type": "string",
"example": "bda55c6b3ba4",
"description": "The ID of the destination on the specified service, such as the YouTube channel ID or the Facebook page ID."
}
}
}
LiveEventDestinationsGetAllAvailableDestinations200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event-destination"
}
}
LiveEventDestinationsGetAllAvailableDestinationsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event-destination"
}
}
LiveEventDestinationsGetAllDestinationsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event-destination"
}
}
LiveEventDestinationsGetAllOttDestinationsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/ott-destination"
}
}
LiveEventDestinationsListAllAvailableDestinationsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/live-event-destination"
}
}
LiveEventDestinationsUpdateDestinationRequest
{
"type": "object",
"properties": {
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"description": "The privacy setting of the destination. Be sure to choose a value that corresponds to your service.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled for simulcasting."
},
"stream_key": {
"type": "string",
"example": "da056692-ba63-4749-a6eb-a476a22b3acd",
"description": "The RTMP stream key."
},
"stream_url": {
"type": "string",
"example": "rtmp://mycooldomain.com/live",
"description": "The RTMP URL for receiving the video stream."
},
"display_name": {
"type": "string",
"example": "My channel",
"description": "The title to display for the simulcast."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "youtube",
"description": "The service to simulcast to.\n\nOption descriptions:\n * `custom_rtmp` - Simulcast to a custom service.\n * `facebook` - Simulcast to Facebook Live.\n * `linkedin` - Simulcast to LinkedIn Live.\n * `youtube` - Simulcast to YouTube Live.\n"
},
"provider_destination_id": {
"type": "string",
"example": "bda55c6b3ba4",
"description": "The ID of the destination on the specified service, such as the YouTube channel ID or the Facebook page ID."
}
}
}
LiveEventLowLatencyToggleOptionRequest
{
"type": "object",
"properties": {
"low_latency": {
"type": "boolean",
"description": "Whether the event is low latency."
}
}
}
LiveEventLowLatencyToggleOptionRequest1
{
"type": "object",
"properties": {
"low_latency": {
"type": "boolean",
"description": "Whether the event is low latency."
}
}
}
LiveEventLowLatencyToggleOptionRequest2
{
"type": "object",
"properties": {
"low_latency": {
"type": "boolean",
"description": "Whether the event is low latency."
}
}
}
LiveEventThumbnailsAddThumbnailRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventThumbnailsCreateThumbnailForEventRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventThumbnailsCreateThumbnailForEventRequest1
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventThumbnailsEditEventThumbnailRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventThumbnailsEditLiveEventThumbnailRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventThumbnailsGetAllResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
LiveEventThumbnailsGetAllThumbnailsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
LiveEventThumbnailsGetAllThumbsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
LiveEventThumbnailsUpdateEventThumbnailRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the thumbnail is the event's active thumbnail."
}
}
}
LiveEventVideosAddMultipleRequest
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to add."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
LiveEventVideosAddMultipleVideosRequest
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to add."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
LiveEventVideosGetAllResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
LiveEventVideosListAllVideosInEventResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
LiveEventVideosListLiveEventVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
LiveEventVideosRemoveMultipleRequest
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to remove."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
LiveEventVideosRemoveMultipleRequest1
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to remove."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
LiveEventVideosRemoveMultipleVideosRequest
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to remove."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
LiveEventVideosUploadMultipleRequest
{
"type": "object",
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"video": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The URI of a video to add."
}
}
}
}
},
"description": "An array of video objects."
}
}
}
OnDemandBackgroundsEditBackgroundOnPageRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether this background image is the one that appears on the On Demand page."
}
}
}
OnDemandBackgroundsGetAllBackgroundsOnPageResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
OnDemandEssentialsCreatePageRequest
{
"type": "object",
"required": [
"content_rating",
"description",
"name",
"type"
],
"properties": {
"buy": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in euros."
},
"GBP": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 2.99,
"description": "The purchase price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 2.99,
"description": "When **type** is `film`, the purchase price of the video in United States dollars. When **type** is `series`, the purchase price of the entire collection in United States dollars."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be purchased. This parameter is required when **rent.active** is `false`."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether people who buy the video can download it. To use this parameter, **type** must be `film`."
}
}
},
"link": {
"type": "string",
"example": "darbyforever",
"description": "The custom string to use in the Vimeo URL of the On Demand page."
},
"name": {
"type": "string",
"example": "Darby Forever",
"description": "The name of the On Demand page."
},
"rent": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in euros."
},
"GBP": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 0.99,
"description": "When **type** is `film`, the rental price of the video in United States dollars. When **type** is `series`, the rental price of the entire collection in United States dollars."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be rented. This parameter is required when **episodes.rent.active** is `true`."
},
"period": {
"enum": [
"1 week",
"1 year",
"24 hour",
"3 month",
"30 day",
"48 hour",
"6 month",
"72 hour"
],
"type": "string",
"description": "The rental period of the video.\n\nOption descriptions:\n * `1 week` - The video can be rented for a maximum of 1 week.\n * `1 year` - The video can be rented for a maximum of 1 year.\n * `24 hour` - The video can be rented for a maximum of 24 hours.\n * `3 month` - The video can be rented for a maximum of 3 months.\n * `30 day` - The video can be rented for a maximum of 30 days.\n * `48 hour` - The video can be rented for a maximum of 48 hours.\n * `6 month` - The video can be rented for a maximum of 6 months.\n * `72 hour` - The video can be rented for a maximum of 72 hours.\n"
}
}
},
"type": {
"enum": [
"film",
"series"
],
"type": "string",
"description": "The type of the On Demand page.\n\nOption descriptions:\n * `film` - The On Demand page is a film.\n * `series` - The On Demand page is a series.\n"
},
"episodes": {
"type": "object",
"properties": {
"buy": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 1.99,
"description": "The purchase price per episode in United States dollars. This parameter is required when **episodes.buy.active** is `true`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether episodes can be purchased."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether people who buy episodes can download them. To use this parameter, **type** must be `series`."
}
}
},
"rent": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 0.99,
"description": "The rental price per episode in United States dollars. This parameter is applicable only when **type** is `series`, and it's required when **episode.rent.active** is `true`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether episodes can be rented."
},
"period": {
"enum": [
"1 week",
"1 year",
"24 hour",
"3 month",
"30 day",
"48 hour",
"6 month",
"72 hour"
],
"type": "string",
"description": "The rental period of the episode.\n\nOption descriptions:\n * `1 week` - The episode can be rented for a maximum of 1 week.\n * `1 year` - The episode can be rented for a maximum of 1 year.\n * `24 hour` - The episode can be rented for a maximum of 24 hours.\n * `3 month` - The episode can be rented for a maximum of 3 months.\n * `30 day` - The episode can be rented for a maximum of 30 days.\n * `48 hour` - The episode can be rented for a maximum of 48 hours.\n * `6 month` - The episode can be rented for a maximum of 6 months.\n * `72 hour` - The episode can be rented for a maximum of 72 hours.\n"
}
}
}
}
},
"description": {
"type": "string",
"example": "DARBY FOREVER follows the fantasies of Darby, a shopgirl at \"Bobbins & Notions\".",
"description": "The description of the On Demand page."
},
"domain_link": {
"type": "string",
"example": "https://example.com",
"description": "The custom domain of the On Demand page."
},
"subscription": {
"type": "object",
"properties": {
"monthly": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"USD": {
"type": "number",
"example": 9.99,
"description": "The monthly subscription price in United States dollars. This parameter is required when **rent.active** and **buy.active** are `false`."
}
}
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether a monthly subscription is active. This parameter is required when **rent.active** and **buy.active** are `false`."
}
}
}
}
},
"content_rating": {
"enum": [
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "string",
"description": "The content rating of the video, given either as a comma-separated list or as a JSON array, depending on the request format.\n\nOption descriptions:\n * `drugs` - The video contains drug or alcohol use.\n * `language` - The video contains profanity or sexually suggestive content.\n * `nudity` - The video contains nudity.\n * `safe` - The video is suitable for all audiences.\n * `unrated` - The video hasn't been rated.\n * `violence` - The video contains violent or graphic content.\n"
},
"accepted_currencies": {
"enum": [
"AUD",
"CAD",
"CHF",
"DKK",
"EUR",
"GBP",
"JPY",
"KRW",
"NOK",
"PLN",
"SEK",
"USD"
],
"type": "string",
"description": "An array of accepted currencies.\n\nOption descriptions:\n * `AUD` - The currency is in Australian dollars.\n * `CAD` - The currency is in Canadian dollars.\n * `CHF` - The currency is in Swiss francs.\n * `DKK` - The currency is in Danish krone.\n * `EUR` - The currency is in euros.\n * `GBP` - The currency is in British pounds.\n * `JPY` - The currency is in Japanese yen.\n * `KRW` - The currency is in South Korean won.\n * `NOK` - The currency is in Norwegian krone.\n * `PLN` - The currency is in Polish zloty.\n * `SEK` - The currency is in Swedish krona.\n * `USD` - The currency is in United States dollars.\n"
}
}
}
OnDemandEssentialsGetAllUserPages200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-page"
}
}
OnDemandEssentialsGetAllUserPagesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-page"
}
}
OnDemandGenresGetAllGenresResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-genre"
}
}
OnDemandGenresGetAllPagesInGenreResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-page"
}
}
OnDemandGenresGetGenresResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-genre"
}
}
OnDemandPostersGetOnDemandPagePostersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
OnDemandPostersUpdatePosterRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether this poster is the one that appears on the On Demand page."
}
}
}
OnDemandPromotionsAddPromotionToPageRequest
{
"type": "object",
"required": [
"download",
"stream_period",
"total",
"type"
],
"properties": {
"code": {
"type": "string",
"example": "sxsw2018",
"description": "The promotion code. This parameter is ignored when the promotion type is `batch`."
},
"type": {
"enum": [
"batch",
"single"
],
"type": "string",
"description": "The type of the promotion. When **access_type** is `vip`, the value for this parameter must be `batch`.\n\nOption descriptions:\n * `batch` - The promotion type that generates many random codes to use one time each.\n * `single` - The promotion type that generates one code to use many times.\n"
},
"label": {
"type": "string",
"example": "sxsw",
"description": "The description of the promotion when the promotion type is `batch`. This parameter is ignored when the promotion type is `single`."
},
"total": {
"type": "number",
"example": 9,
"description": "When **type** is `batch`, the total number of promotions to generate. When **type** is `single`, the total number of uses of the promotion."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether the promotion grants download access to On Demand content. This field is required only when the download access hasn't been defined in the On Demand container, or when **access_type** is `vip` or **product_type** is `buy`."
},
"end_time": {
"type": "string",
"example": "1526089920",
"description": "The time at which the promotion period ends. If this parameter has no value, the promotion never expires."
},
"start_time": {
"type": "string",
"example": "1526089920",
"description": "The time at which the promotion period starts. If this parameter has no value, the start time defaults to the time at which the promotion was created."
},
"access_type": {
"enum": [
"default",
"vip"
],
"type": "string",
"description": "The promotion access type, which is a purchase option that isn't available in the On Demand container. Use the **download** and **stream_period** parameters to define additional characteristics for the `vip` type.\n\nOption descriptions:\n * `default` - The promotion grants a discount on the existing purchase options for an On Demand container.\n * `vip` - The promotion grants free access to On Demand content before it's released.\n"
},
"percent_off": {
"type": "number",
"example": 50,
"description": "The percentage of the discount. This parameter is applicable only when **discount_type** is `percent`."
},
"product_type": {
"enum": [
"any",
"buy",
"buy_episode",
"rent",
"rent_episode",
"subscribe"
],
"type": "string",
"description": "The type of transaction to which the promotion applies. When **access_type** is `default`, the default value is `any`. When **access_type** is `vip`, the default value is `rent` and the only valid product types are `buy` and `rent`.\n\nOption descriptions:\n * `any` - The promotion applies to any transaction.\n * `buy` - The promotion applies only to purchased products.\n * `buy_episode` - The promotion applies only to purchased episodes.\n * `rent` - The promotion applies only to rented products.\n * `rent_episode` - The promotion applies only to rented episodes.\n * `subscribe` - The promotion applies only to subscriptions.\n"
},
"discount_type": {
"enum": [
"free",
"percent"
],
"type": "string",
"description": "The type of discount offered by the promotion code. When **access_type** is `vip`, the value of this parameter must be `free`.\n\nOption descriptions:\n * `free` - The discount reduces the price to zero.\n * `percent` - The discount reduces the price by the percentage defined in the **percent_off** parameter.\n"
},
"stream_period": {
"enum": [
"1_week",
"1_year",
"24_hour",
"30_day",
"3_month",
"48_hour",
"6_month",
"72_hour"
],
"type": "string",
"description": "The amount of time for which the user can access On Demand content upon redeeming a promotion code. This parameter is required only when the streaming period isn't defined in the On Demand container, or when creating promotions where **access_type** is `vip` or **product_type** is `rent`.\n\nOption descriptions:\n * `1_week` - The user can access On Demand content for a maximum of 1 week after redeeming a promotion code.\n * `1_year` - The user can access On Demand content for a maximum of 1 year after redeeming a promotion code.\n * `24_hour` - The user can access On Demand content for a maximum of 24 hours after redeeming a promotion code.\n * `30_day` - The user can access On Demand content for a maximum of 30 days after redeeming a promotion code.\n * `3_month` - The user can access On Demand content for a maximum of 3 months after redeeming a promotion code.\n * `48_hour` - The user can access On Demand content for a maximum of 48 hours after redeeming a promotion code.\n * `6_month` - The user can access On Demand content for a maximum of 6 months after redeeming a promotion code.\n * `72_hour` - The user can access On Demand content for a maximum of 72 hours after redeeming a promotion code.\n"
}
}
}
OnDemandPurchasesAndRentalsGetAllUserPurchasesAndRentalsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-page"
}
}
OnDemandPurchasesAndRentalsListUserPurchasesAndRentalsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-page"
}
}
OnDemandRegionsAddMultipleRequest
{
"type": "object",
"required": [
"countries"
],
"properties": {
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of country codes for the regions to add."
}
}
}
OnDemandRegionsGetAllResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-region"
}
}
OnDemandRegionsRemoveMultipleRequest
{
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of country codes for the regions to remove."
}
}
}
OnDemandRegionsRemoveMultipleResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-region"
}
}
OnDemandSeasonsGetAllVideosInSeasonResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
OnDemandSeasonsListAllResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-season"
}
}
OnDemandVideosAddVideoToPageRequest
{
"type": "object",
"required": [
"type"
],
"properties": {
"buy": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in euros."
},
"GBP": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 1.99,
"description": "The purchase price of the video in United States dollars. This parameter is required when **buy.active** is `true`."
}
}
}
}
},
"rent": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"AUD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Australian dollars."
},
"CAD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Canadian dollars."
},
"CHF": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swiss francs."
},
"DKK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Danish krone."
},
"EUR": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in euros."
},
"GBP": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in British pounds."
},
"JPY": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Japanese yen."
},
"KRW": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in South Korean won."
},
"NOK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Norwegian krone."
},
"PLN": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Polish zloty."
},
"SEK": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in Swedish krona."
},
"USD": {
"type": "number",
"example": 0.99,
"description": "The rental price of the video in United States dollars. This parameter is required when **rent.active** is `true`."
}
}
}
}
},
"type": {
"enum": [
"extra",
"main",
"trailer"
],
"type": "string",
"description": "The type of the video.\n\nOption descriptions:\n * `extra` - The video type is extra footage.\n * `main` - The video type is the main video.\n * `trailer` - The video type is a trailer.\n"
},
"position": {
"type": "number",
"example": 10,
"description": "The position of the video in the On Demand collection."
},
"release_year": {
"type": "number",
"example": 2018,
"description": "The release year of the video."
}
}
}
OnDemandVideosGetAllVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-video"
}
}
PaymentsEssentialsListPaymentMethodsRequest
{
"type": "object",
"properties": {
"type": {
"enum": [
"applepay",
"bank_account",
"card",
"googlepay",
"paypal"
],
"type": "string",
"description": "The type of payment method.\n\nOption descriptions:\n * `applepay` - The payment method is Apple Pay.\n * `bank_account` - The payment method is a bank account.\n * `card` - The payment method is a credit or debit card.\n * `googlepay` - The payment method is Google Pay.\n * `paypal` - The payment method is a PayPal account.\n"
}
}
}
PaymentsEssentialsListPaymentMethodsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/payment-method"
}
}
PortfoliosEssentialsGetAllUserPortfoliosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/portfolio"
}
}
PortfoliosVideosGetAllPortfolioVideos200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
PortfoliosVideosGetAllPortfolioVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
SearchUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
SearchVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
ShowcasesCustomShowcaseLogosListAllCustomLogosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
ShowcasesCustomShowcaseLogosReplaceLogoRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to make this image the active showcase logo."
}
}
}
ShowcasesCustomShowcaseThumbnailsListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
ShowcasesCustomShowcaseThumbnailsReplaceCustomThumbnailRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to make this image the active custom showcase thumbnail."
}
}
}
ShowcasesEssentialsCreateUserShowcaseRequest
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Vimeo Holiday Videos!",
"description": "The name of the showcase."
},
"sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"description": "The default sort order of the videos as they appear in the showcase.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the showcase, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the showcase, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the showcase.\n * `comments` - The videos appear according to their number of comments.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order with the newest first.\n * `oldest` - The videos appear in chronological order with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"theme": {
"enum": [
"dark",
"standard"
],
"type": "string",
"description": "The color theme of the showcase.\n\nOption descriptions:\n * `dark` - The showcase uses the dark theme.\n * `standard` - The showcase uses the standard theme.\n"
},
"layout": {
"enum": [
"grid",
"player"
],
"type": "string",
"description": "The type of layout for presenting the showcase.\n\nOption descriptions:\n * `grid` - The videos appear in a grid.\n * `player` - The videos appear in the player.\n"
},
"privacy": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"team",
"unlisted"
],
"type": "string",
"description": "The privacy level of the showcase.\n\nOption descriptions:\n * `anybody` - Anyone can access the showcase, either on Vimeo or through an embed.\n * `embed_only` - The showcase doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one can access the showcase, including the authenticated user.\n * `password` - Only those with the password can access the showcase.\n * `team` - Only members of the authenticated user's team can access the showcase.\n * `unlisted` - The showcase can't be accessed if the URL omits its unlisted hash.\n"
},
"hide_nav": {
"type": "boolean",
"example": true,
"description": "Whether to hide Vimeo navigation when displaying the showcase."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The showcase's password. This field is required only when **privacy** is `password`."
},
"brand_color": {
"type": "string",
"example": "ff66ee",
"description": "The hexadecimal code for the color of the player buttons and showcase controls."
},
"description": {
"type": "string",
"example": "Vimeo holiday videos!",
"description": "The description of the showcase."
},
"review_mode": {
"type": "boolean",
"example": true,
"description": "Whether showcase videos use the review mode URL."
},
"hide_upcoming": {
"type": "boolean",
"example": false,
"description": "Whether to include the upcoming event in the showcase."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether the showcase should be hidden from Vimeo when unlisted."
}
}
}
ShowcasesEssentialsEditShowcaseRequest
{
"type": "object",
"properties": {
"url": {
"type": "string",
"example": "my-custom-url",
"nullable": true,
"description": "The custom Vimeo URL of the showcase."
},
"name": {
"type": "string",
"example": "Vimeo Holiday Videos!",
"description": "The name of the showcase."
},
"sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"description": "The default sort order of the videos as they appear in the showcase.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the showcase, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the showcase, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the showcase.\n * `comments` - The videos appear according to their number of comments.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order with the newest first.\n * `oldest` - The videos appear in chronological order with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"theme": {
"enum": [
"dark",
"standard"
],
"type": "string",
"description": "The color theme of the showcase.\n\nOption descriptions:\n * `dark` - The showcase uses the dark theme.\n * `standard` - The showcase uses the standard theme.\n"
},
"domain": {
"type": "string",
"example": "mycustomdomain.com",
"nullable": true,
"description": "The custom domain of the showcase."
},
"layout": {
"enum": [
"grid",
"player"
],
"type": "string",
"description": "The type of layout for presenting the showcase.\n\nOption descriptions:\n * `grid` - The videos appear in a grid.\n * `player` - The videos appear in the player.\n"
},
"privacy": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"team",
"unlisted"
],
"type": "string",
"description": "The privacy level of the showcase.\n\nOption descriptions:\n * `anybody` - Anyone can access the showcase, either on Vimeo or through an embed.\n * `embed_only` - The showcase doesn't appear on Vimeo, but it can be embedded on other sites.\n * `nobody` - No one can access the showcase, including the authenticated user.\n * `password` - Only people with the password can access the showcase.\n * `team` - Only members of the authenticated user's team can access the showcase.\n * `unlisted` - The showcase can't be accessed if the URL omits its unlisted hash.\n"
},
"hide_nav": {
"type": "boolean",
"example": true,
"description": "Whether to hide Vimeo navigation when displaying the showcase."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The showcase's password. This field is required only when **privacy** is `password`."
},
"brand_color": {
"type": "string",
"example": "ff66ee",
"description": "The hexadecimal code for the color of the player buttons and showcase controls."
},
"description": {
"type": "string",
"example": "Vimeo holiday videos!",
"description": "The description of the showcase."
},
"review_mode": {
"type": "boolean",
"example": true,
"description": "Whether showcase videos use the review mode URL."
},
"hide_upcoming": {
"type": "boolean",
"example": false,
"description": "Whether to include the upcoming event in the showcase."
},
"use_custom_domain": {
"type": "boolean",
"example": true,
"description": "Whether the user has opted for a custom domain for their showcase."
}
}
}
ShowcasesEssentialsGetAllUserShowcasesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/album"
}
}
ShowcasesShowcaseVideosCreateShowcaseThumbnailRequest
{
"type": "object",
"properties": {
"time_code": {
"type": "number",
"example": 300,
"description": "The time in seconds of the video frame to use as the thumbnail image."
}
}
}
ShowcasesShowcaseVideosCreateShowcaseThumbnailRequest1
{
"type": "object",
"properties": {
"time_code": {
"type": "number",
"example": 300,
"description": "The time in seconds of the video frame to use as the thumbnail image."
}
}
}
ShowcasesShowcaseVideosGetShowcaseVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
ShowcasesShowcaseVideosListAvailableShowcasesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/album"
}
}
ShowcasesShowcaseVideosListInShowcase200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
ShowcasesShowcaseVideosListInShowcaseResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
ShowcasesShowcaseVideosReplaceShowcaseVideosRequest
{
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "string",
"example": "/videos/258684937,/videos/273576296",
"description": "A comma-separated list of video URIs corresponding to the videos to add."
}
}
}
ShowcasesShowcaseVideosReplaceVideosRequest
{
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "string",
"example": "/videos/258684937,/videos/273576296",
"description": "A comma-separated list of video URIs corresponding to the videos to add."
}
}
}
UpdateWebinarRequest
{
"type": "object",
"properties": {
"title": {
"type": "string",
"example": "Interviews Daily",
"description": "The title of the webinar."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"description": "The status of the webinar.\n\nOption descriptions:\n * `ended` - The webinar has ended.\n * `started` - The webinar has started.\n"
},
"privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"password",
"team"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the webinar. This can't be updated once the webinar is in session.\n\nOption descriptions:\n * `anybody` - Anyone can access the webinar. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - No one except the owner can access the webinar. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the live event.\n * `team` - Only members of the authenticated user's team can access the webinar.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The initial embed privacy of the webinar.\n\nOption descriptions:\n * `private` - The webinar can't be embedded on any domain.\n * `public` - The webinar can be embedded on any domain.\n * `whitelist` - The webinar can be embedded on whitelisted domains only.\n"
}
},
"description": "The privacy settings of the webinar."
},
"password": {
"type": "string",
"example": "gogo",
"description": "The password when **privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the webinar event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the webinar is expected to be live.\n\nOption descriptions:\n * `single` - The webinar is live one time only.\n * `weekly` - The webinar is live on a weekly basis. _This field is deprecated._\n"
},
"end_time": {
"type": "string",
"example": "2019-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to end, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the webinar is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
}
},
"description": "Information about the time or times that the webinar is expected to be live. Please note that you can't update this setting once the webinar has started."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in the automatically generated video titles for the webinar."
},
"description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the webinar."
},
"email_settings": {
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar. _This field is deprecated._"
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos/2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar. _This field is deprecated._"
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar. _This field is deprecated._"
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address. _This field is deprecated._"
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address. _This field is deprecated._"
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar. _This field is deprecated._"
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts. _This field is deprecated._"
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails. _This field is deprecated._"
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts. _This field is deprecated._"
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts. _This field is deprecated._"
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration. _This field is deprecated._"
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows. _This field is deprecated._"
}
},
"description": "The preferences for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy. _This field is deprecated._"
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar. _This field is deprecated._"
}
},
"description": "The settings for emails that are sent about the webinar. _This field is deprecated._"
}
}
}
UploadVideoRequest
{
"type": "object",
"required": [
"upload"
],
"properties": {
"name": {
"type": "string",
"example": "Celebrating 10 Years of Staff Picks",
"description": "The title of the video."
},
"embed": {
"type": "object",
"properties": {
"color": {
"type": "string",
"example": "#1ab7ea",
"description": "The main color of the embeddable player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embeddable player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the active custom logo on the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo is always visible on the embeddable player (`true`) or whether the logo appears and disappears with the rest of the UI (`false`)."
}
}
}
}
},
"title": {
"type": "object",
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the video title in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the video title.\n * `show` - Show the video title.\n * `user` - Enable the user to decide.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner information in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the owner info.\n * `show` - Show the owner info.\n * `user` - Enable the user to decide.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner portrait in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the portrait.\n * `show` - Show the portrait.\n * `user` - Enable the user to decide.\n"
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether to show the volume selector on the embeddable player."
},
"buttons": {
"type": "object",
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether to show the `HD` button on the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether to show the `like` button on the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether to show the `embed` button on the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether to show the `share` button on the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether to show the `scaling` button on the embeddable player in fullscreen mode."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether to show the `fullscreen` button on the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether to show the `watch later` button on the embeddable player."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether to show the playbar on the embeddable player."
},
"end_screen": {
"type": "object",
"properties": {
"type": {
"enum": [
"empty",
"loop",
"share",
"thumbnail"
],
"type": "string",
"description": "The end screen type.\n\nOption descriptions:\n * `empty` - The end screen is empty.\n * `loop` - The end screen loops the video playback.\n * `share` - The end screen includes sharing options.\n * `thumbnail` - The end screen includes the thumbnail of the video.\n"
}
}
}
}
},
"locale": {
"type": "string",
"example": "en_US",
"description": "The video's default language. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
},
"upload": {
"type": "object",
"required": [
"approach"
],
"properties": {
"link": {
"type": "string",
"example": "https://example.com/video.mp4",
"description": "The public URL at which the video is hosted. The URL must be valid for at least 24 hours. Use this parameter when **approach** is `pull`."
},
"size": {
"type": "string",
"example": "13623861",
"description": "The size in bytes of the video to upload. The maximum value of this field is `268435456000`, which corresponds to 250 GB."
},
"approach": {
"enum": [
"post",
"pull",
"tus"
],
"type": "string",
"description": "The upload approach.\n\nOption descriptions:\n * `post` - Use the `post` approach.\n * `pull` - Use the `pull` approach.\n * `tus` - Use the `tus` approach.\n"
},
"redirect_url": {
"type": "string",
"example": "https://example.com",
"description": "The app's redirect URL. Use this parameter when **approach** is `post`."
}
}
},
"license": {
"enum": [
"by",
"by-nc",
"by-nc-nd",
"by-nc-sa",
"by-nd",
"by-sa",
"cc0"
],
"type": "string",
"description": "The Creative Commons license under which the video is offered.\n\nOption descriptions:\n * `by` - The video is offered under CC BY, or the attibution-only license.\n * `by-nc` - The video is offered under CC BY-NC, or the Attribution-NonCommercial license.\n * `by-nc-nd` - The video is offered under CC BY-NC-ND, or the Attribution-NonCommercian-NoDerivs license.\n * `by-nc-sa` - The video is offered under CC BY-NC-SA, or the Attribution-NonCommercial-ShareAlike licence.\n * `by-nd` - The video is offered under CC BY-ND, or the Attribution-NoDerivs license.\n * `by-sa` - The video is offered under CC BY-SA, or the Attribution-ShareAlike license.\n * `cc0` - The video is offered under CC0, or the public domain license.\n"
},
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether a user can add the video to a showcase, channel, or group."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"description": "The video's privacy setting. When this value is `users`, `application/json` is the only valid content type. Also, some privacy settings are unavailable to Vimeo Free members; for more information, see our [Help Center](https://vimeo.zendesk.com/hc/en-us/articles/224817847).\n\nOption descriptions:\n * `anybody` - Anyone can access the video. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only those who follow the owner on Vimeo can access the video. _This field is deprecated._\n * `disable` - The video is embeddable, but it's hidden on Vimeo and can't be played. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end. _This field is deprecated._\n * `nobody` - No one except the owner can access the video. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the video.\n * `unlisted` - Only those with the private link can access the video.\n * `users` - Only Vimeo members can access the video. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"description": "The video's embed setting. Specify the `whitelist` value to restrict embedding to a specific set of domains. For more information, see our [Interacting with Videos](https://developer.vimeo.com/api/guides/videos/interact#set-off-site-privacy) guide.\n\nOption descriptions:\n * `private` - The video can't be embedded.\n * `public` - The video can be embedded.\n * `whitelist` - The video can be embedded on the specified domains only.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"description": "The privacy level required to comment on the video.\n\nOption descriptions:\n * `anybody` - Anyone can comment on the video.\n * `contacts` - Only the video owner's contacts can comment on the video.\n * `nobody` - No one can comment on the video.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether a user can download the video. This field isn't available to Vimeo Free members."
}
}
},
"spatial": {
"type": "object",
"properties": {
"projection": {
"enum": [
"cubical",
"cylindrical",
"dome",
"equirectangular",
"pyramid"
],
"type": "string",
"description": "The 360 spatial projection.\n\nOption descriptions:\n * `cubical` - Use cubical projection.\n * `cylindrical` - Use cylindrical projection.\n * `dome` - Use dome projection.\n * `equirectangular` - Use equirectangular projection.\n * `pyramid` - Use pyramid projection.\n"
},
"field_of_view": {
"type": "number",
"example": 50,
"description": "The 360 field of view. This value must be between `30` and `90`; the default value is `50`."
},
"stereo_format": {
"enum": [
"left-right",
"mono",
"top-bottom"
],
"type": "string",
"description": "The 360 spatial stereo format.\n\nOption descriptions:\n * `left-right` - Use left-right stereo.\n * `mono` - Use monaural audio.\n * `top-bottom` - Use top-bottom stereo.\n"
},
"director_timeline": {
"type": "array",
"items": {
"type": "object",
"required": [
"pitch",
"time_code",
"yaw"
],
"properties": {
"yaw": {
"type": "number",
"example": 125,
"description": "The 360 director timeline yaw. This value must be between `0` and `360`, and it's required only when **spatial.director_timeline** is defined."
},
"roll": {
"type": "number",
"description": "The 360 director timeline roll."
},
"pitch": {
"type": "number",
"example": 70,
"description": "The 360 director timeline pitch. This value must be between `−90` and `90`, and it's required only when **spatial.director_timeline** is defined."
},
"time_code": {
"type": "number",
"example": 5,
"description": "The 360 director timeline time code. This field is required only when **spatial.director_timeline** is defined."
}
}
},
"description": "An array representing the 360 director timeline."
}
}
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The password. This field is required when **privacy.view** is `password`."
},
"folder_uri": {
"type": "string",
"example": "/users/12345/folders/6789",
"description": "The URI of the folder to which the video is uploaded."
},
"description": {
"type": "string",
"example": "A celebration of 10 years of Staff Picks.",
"description": "The description of the video."
},
"review_page": {
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to enable video review."
}
}
},
"embed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "The complete list of domains the video can be embedded on. This field requires that **privacy_embed** have the value `whitelist`."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this video. For a full list of values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether to hide the video from everyone except the video's owner. When the value is `true`, unlisted video links work only for the video's owner."
}
}
}
UsersAnalyticsGetMetricsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/analytics"
}
}
UsersAnalyticsGetUserMetricsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/analytics"
}
}
UsersEssentialsEditVimeoAccountRequest
{
"type": "object",
"properties": {
"bio": {
"type": "string",
"example": "This is where you will find videos and news updates from the staff",
"description": "The user's bio."
},
"link": {
"type": "string",
"example": "staff",
"description": "The user's custom Vimeo URL."
},
"name": {
"type": "string",
"example": "Vimeo Staff",
"description": "The user's display name."
},
"gender": {
"enum": [
"f",
"m",
"n",
"o"
],
"type": "string",
"description": "The authenticated user's gender.\n\nOption descriptions:\n * `f` - The user's preferred pronouns are she and her.\n * `m` - The user's preferred pronouns are he and him.\n * `n` - The user would rather not give preferred pronouns.\n * `o` - The user's preferred pronouns are they and them.\n"
},
"videos": {
"type": "object",
"properties": {
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether the user can add videos to showcases, channels, or groups by default."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"description": "Who can access the user's videos by default.\n\nOption descriptions:\n * `anybody` - Anyone can access the videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only the user's contacts can access the videos. _This field is deprecated._\n * `disable` - The videos are disabled. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end.\n * `nobody` - No one can access the videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the videos.\n * `unlisted` - The videos are unlisted.\n * `users` - Only other Vimeo members can access the videos. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"description": "The privacy for the user's embedded videos. The whitelist value enables you to define all valid embeddable domains. See our [Interacting with Videos](https://developer.vimeo.com/api/guides/videos/interact#set-off-site-privacy) guide for details on adding and removing domains.\n\nOption descriptions:\n * `private` - The videos can't be embedded on any domain.\n * `public` - The videos can be embedded on any domain.\n * `whitelist` - The videos can be embedded on the specified domains only.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"description": "Who can comment on the user's video uploads by default.\n\nOption descriptions:\n * `anybody` - Anyone can comment.\n * `contacts` - Only the user's contacts can comment.\n * `nobody` - No one can comment.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether the user can download videos. This value becomes the default download setting for all future videos that the user uploads."
}
}
}
}
},
"location": {
"type": "string",
"example": "New York City",
"description": "The user's location."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The default password for all future videos that this user uploads. To use this field, the **videos.privacy.view** field must be `password`."
},
"content_filter": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in the user's videos. Find the full list in the [/contentratings](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint. You must provide a comma-separated list if you're using a query string or an array if you're using JSON."
}
}
}
UsersFeedsGetUserFeedVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/activity-3-1"
}
}
UsersFollowersFollowMultipleUsersRequest
{
"type": "object",
"required": [
"users"
],
"properties": {
"users": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of user IDs for the authenticated user to follow."
}
}
}
UsersFollowersListAllResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
UsersFollowersListOfFollowedUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
UsersFollowersListOfFollowingUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
UsersPicturesEditPortraitImageRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether the picture is the authenticated user's active portrait."
}
}
}
UsersPicturesListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
UsersWatchHistoryGetWatchedVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
VideosAnimatedThumbnailsCreateSetRequest
{
"type": "object",
"required": [
"duration"
],
"properties": {
"duration": {
"type": "number",
"example": 5,
"description": "The duration of the animation in seconds. The maximum value is 6."
},
"start_time": {
"type": "number",
"example": 2,
"description": "The time in seconds corresponding to the start of the animation in the video. The default value is 0."
}
}
}
VideosAnimatedThumbnailsGetAllSetsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/animated-thumbset"
}
}
VideosChaptersGenerateChapterThumbnailOrUploadLinkRequest
{
"type": "object",
"properties": {
"timecode": {
"type": "number",
"example": 140,
"description": "The timecode, given in seconds from the start of the video, indicating when the thumbnail should be generated from the video."
}
}
}
VideosChaptersGenerateChapterThumbnailRequest
{
"type": "object",
"properties": {
"timecode": {
"type": "number",
"example": 140,
"description": "The timecode, given in seconds from the start of the video, indicating when the thumbnail should be generated from the video."
}
}
}
VideosChaptersSetChapterThumbnailActiveRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to set the chapter thumbnail as active."
}
}
}
VideosContentRatingsGetAllContentRatingsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/content-rating"
}
}
VideosCreativeCommonsGetAllCcLicensesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/creative-commons"
}
}
VideosCreditsAddUserCreditInVideoRequest
{
"type": "object",
"required": [
"email",
"name",
"role",
"user_uri"
],
"properties": {
"name": {
"type": "string",
"example": "Sam Doe",
"description": "The name of the credited person."
},
"role": {
"type": "string",
"example": "Producer",
"description": "The role of the credited person."
},
"email": {
"type": "string",
"example": "user@example.com",
"description": "The email address of the credited person."
},
"user_uri": {
"type": "string",
"example": "/users/152184",
"description": "The Vimeo URI of the credited person."
}
}
}
VideosCreditsAddUserCreditRequest
{
"type": "object",
"required": [
"email",
"name",
"role",
"user_uri"
],
"properties": {
"name": {
"type": "string",
"example": "Sam Doe",
"description": "The name of the credited person."
},
"role": {
"type": "string",
"example": "Producer",
"description": "The role of the credited person."
},
"email": {
"type": "string",
"example": "user@example.com",
"description": "The email address of the credited person."
},
"user_uri": {
"type": "string",
"example": "/users/152184",
"description": "The Vimeo URI of the credited person."
}
}
}
VideosCreditsEditUserCreditInVideoRequest
{
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Sam Doe",
"description": "The name of the credited person."
},
"role": {
"type": "string",
"example": "Producer",
"description": "The role of the credited person."
}
}
}
VideosCreditsGetAllCreditedUsersInVideo200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/credit"
}
}
VideosCreditsGetAllCreditedUsersInVideoResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/credit"
}
}
VideosEmbedPrivacyListWhitelistDomainsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/domain"
}
}
VideosEssentialsGetAllUserVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
VideosEssentialsGetUserAppearancesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
VideosRecommendationsGetRelatedVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
VideosShowcasesAddToMultipleShowcasesRequest
{
"type": "object",
"properties": {
"add": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"description": "The showcase URI to add the video to."
}
}
},
"description": "The array of showcases to add the video to. Specify these with a batch request; see our [Using Common Formats and Parameters](https://developer.vimeo.com/api/common-formats#working-with-batch-requests) guide for more information."
},
"remove": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"description": "The showcase URI to remove the video from."
}
}
},
"description": "The array of showcases to remove the video from. Specify these with a batch request; see our [Using Common Formats and Parameters](https://developer.vimeo.com/api/common-formats#working-with-batch-requests) guide for more information."
}
}
}
VideosShowcasesAddToMultipleShowcasesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/album"
}
}
VideosShowcasesGetAllContShowcasesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/album"
}
}
VideosTagsAddMultipleResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
}
}
VideosTagsGetAllByTagResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
VideosTagsGetVideoTagsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
}
}
VideosTextTracksAddTextTrackRequest
{
"type": "object",
"required": [
"language",
"name",
"type"
],
"properties": {
"name": {
"type": "string",
"example": "Commentary",
"description": "The name of the text track."
},
"type": {
"enum": [
"captions",
"chapters",
"descriptions",
"metadata",
"subtitles"
],
"type": "string",
"description": "The type of text track.\n\nOption descriptions:\n * `captions` - The text track is the captions type.\n * `chapters` - The text track is the chapters type.\n * `descriptions` - The text track is the descriptions type.\n * `metadata` - The text track is the metadata type.\n * `subtitles` - The text track is the subtitles type.\n"
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the current text track is the *active text track,* or the one that appears in the player. Only one text track per language and type can be active."
},
"language": {
"type": "string",
"example": "en-US",
"description": "The language of the text track. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
},
"is_edited": {
"type": "boolean",
"description": "Whether the text track was uploaded by the Seshat audio annotation management platform after the user edited their transcript."
},
"is_auto_generated": {
"type": "boolean",
"description": "Whether the text track was uploaded automatically by the Seshat audio annotation management platform."
}
}
}
VideosTextTracksAddTextTrackToVideoRequest
{
"type": "object",
"required": [
"language",
"name",
"type"
],
"properties": {
"name": {
"type": "string",
"example": "Commentary",
"description": "The name of the text track."
},
"type": {
"enum": [
"captions",
"chapters",
"descriptions",
"metadata",
"subtitles"
],
"type": "string",
"description": "The type of text track.\n\nOption descriptions:\n * `captions` - The text track is the captions type.\n * `chapters` - The text track is the chapters type.\n * `descriptions` - The text track is the descriptions type.\n * `metadata` - The text track is the metadata type.\n * `subtitles` - The text track is the subtitles type.\n"
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the current text track is the *active text track,* or the one that appears in the player. Only one text track per language and type can be active."
},
"language": {
"type": "string",
"example": "en-US",
"description": "The language of the text track. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
},
"is_edited": {
"type": "boolean",
"description": "Whether the text track was uploaded by the Seshat audio annotation management platform after the user edited their transcript."
},
"is_auto_generated": {
"type": "boolean",
"description": "Whether the text track was uploaded automatically by the Seshat audio annotation management platform."
}
}
}
VideosTextTracksEditTextTrackRequest
{
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Commentary",
"description": "The name of the text track."
},
"type": {
"enum": [
"captions",
"chapters",
"descriptions",
"metadata",
"subtitles"
],
"type": "string",
"description": "The type of text track.\n\nOption descriptions:\n * `captions` - The text track is the captions type.\n * `chapters` - The text track is the chapters type.\n * `descriptions` - The text track is the descriptions type.\n * `metadata` - The text track is the metadata type.\n * `subtitles` - The text track is the subtitles type.\n"
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the current text track is the *active text track,* or the one that appears in the player. Only one text track per language and per type can be active."
},
"language": {
"type": "string",
"example": "en-US",
"description": "The language of the text track. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
}
}
}
VideosTextTracksGetAllTracksResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/text-track"
}
}
VideosTextTracksGetAllVideoTracksResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/text-track"
}
}
VideosThumbnailsAddThumbnailToVideoRequest
{
"type": "object",
"properties": {
"time": {
"type": "number",
"example": 300,
"description": "The time offset in seconds from which to create the thumbnail."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the image created by the **time** field should be the default thumbnail for the video."
}
}
}
VideosThumbnailsAddThumbnailToVideoRequest1
{
"type": "object",
"properties": {
"time": {
"type": "number",
"example": 300,
"description": "The time offset in seconds from which to create the thumbnail."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the image created by the **time** field should be the default thumbnail for the video."
}
}
}
VideosThumbnailsEditThumbnailImageRequest
{
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether this thumbnail is the default."
}
}
}
VideosThumbnailsGetAllByVideoId200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
VideosThumbnailsGetAllByVideoIdResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
}
}
VideosUnlistedVideosGrantAccessToUsers200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
VideosUnlistedVideosGrantAccessToUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
VideosUnlistedVideosListAccessibleUsers200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
VideosUnlistedVideosListAccessibleUsersResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/user"
}
}
VideosUploadsBeginVideoUploadProcessRequest
{
"type": "object",
"required": [
"upload"
],
"properties": {
"name": {
"type": "string",
"example": "Celebrating 10 Years of Staff Picks",
"description": "The title of the video."
},
"embed": {
"type": "object",
"properties": {
"color": {
"type": "string",
"example": "#1ab7ea",
"description": "The main color of the embeddable player."
},
"logos": {
"type": "object",
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether to show the Vimeo logo on the embeddable player."
},
"custom": {
"type": "object",
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The URL that loads when the user clicks the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether to show the active custom logo on the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo is always visible on the embeddable player (`true`) or whether the logo appears and disappears with the rest of the UI (`false`)."
}
}
}
}
},
"title": {
"type": "object",
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the video title in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the video title.\n * `show` - Show the video title.\n * `user` - Enable the user to decide.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner information in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the owner info.\n * `show` - Show the owner info.\n * `user` - Enable the user to decide.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"description": "How to handle the owner portrait in the title bar of the embeddable player.\n\nOption descriptions:\n * `hide` - Hide the portrait.\n * `show` - Show the portrait.\n * `user` - Enable the user to decide.\n"
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether to show the volume selector on the embeddable player."
},
"buttons": {
"type": "object",
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether to show the `HD` button on the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether to show the `like` button on the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether to show the `embed` button on the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether to show the `share` button on the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether to show the `scaling` button on the embeddable player in fullscreen mode."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether to show the `fullscreen` button on the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether to show the `watch later` button on the embeddable player."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether to show the playbar on the embeddable player."
},
"end_screen": {
"type": "object",
"properties": {
"type": {
"enum": [
"empty",
"loop",
"share",
"thumbnail"
],
"type": "string",
"description": "The end screen type.\n\nOption descriptions:\n * `empty` - The end screen is empty.\n * `loop` - The end screen loops the video playback.\n * `share` - The end screen includes sharing options.\n * `thumbnail` - The end screen includes the thumbnail of the video.\n"
}
}
}
}
},
"locale": {
"type": "string",
"example": "en_US",
"description": "The video's default language. For a full list of supported languages, use the [`/languages?filter=texttracks`](https://developer.vimeo.com/api/reference/videos#get_languages) endpoint."
},
"upload": {
"type": "object",
"required": [
"approach"
],
"properties": {
"link": {
"type": "string",
"example": "https://example.com/video.mp4",
"description": "The public URL at which the video is hosted. The URL must be valid for at least 24 hours. Use this parameter when **approach** is `pull`."
},
"size": {
"type": "string",
"example": "13623861",
"description": "The size in bytes of the video to upload. The maximum value of this field is `268435456000`, which corresponds to 250 GB."
},
"approach": {
"enum": [
"post",
"pull",
"tus"
],
"type": "string",
"description": "The upload approach.\n\nOption descriptions:\n * `post` - Use the `post` approach.\n * `pull` - Use the `pull` approach.\n * `tus` - Use the `tus` approach.\n"
},
"redirect_url": {
"type": "string",
"example": "https://example.com",
"description": "The app's redirect URL. Use this parameter when **approach** is `post`."
}
}
},
"license": {
"enum": [
"by",
"by-nc",
"by-nc-nd",
"by-nc-sa",
"by-nd",
"by-sa",
"cc0"
],
"type": "string",
"description": "The Creative Commons license under which the video is offered.\n\nOption descriptions:\n * `by` - The video is offered under CC BY, or the attibution-only license.\n * `by-nc` - The video is offered under CC BY-NC, or the Attribution-NonCommercial license.\n * `by-nc-nd` - The video is offered under CC BY-NC-ND, or the Attribution-NonCommercian-NoDerivs license.\n * `by-nc-sa` - The video is offered under CC BY-NC-SA, or the Attribution-NonCommercial-ShareAlike licence.\n * `by-nd` - The video is offered under CC BY-ND, or the Attribution-NoDerivs license.\n * `by-sa` - The video is offered under CC BY-SA, or the Attribution-ShareAlike license.\n * `cc0` - The video is offered under CC0, or the public domain license.\n"
},
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether a user can add the video to a showcase, channel, or group."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"description": "The video's privacy setting. When this value is `users`, `application/json` is the only valid content type. Also, some privacy settings are unavailable to Vimeo Free members; for more information, see our [Help Center](https://vimeo.zendesk.com/hc/en-us/articles/224817847).\n\nOption descriptions:\n * `anybody` - Anyone can access the video. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only those who follow the owner on Vimeo can access the video. _This field is deprecated._\n * `disable` - The video is embeddable, but it's hidden on Vimeo and can't be played. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end. _This field is deprecated._\n * `nobody` - No one except the owner can access the video. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the video.\n * `unlisted` - Only those with the private link can access the video.\n * `users` - Only Vimeo members can access the video. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"description": "The video's embed setting. Specify the `whitelist` value to restrict embedding to a specific set of domains. For more information, see our [Interacting with Videos](https://developer.vimeo.com/api/guides/videos/interact#set-off-site-privacy) guide.\n\nOption descriptions:\n * `private` - The video can't be embedded.\n * `public` - The video can be embedded.\n * `whitelist` - The video can be embedded on the specified domains only.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"description": "The privacy level required to comment on the video.\n\nOption descriptions:\n * `anybody` - Anyone can comment on the video.\n * `contacts` - Only the video owner's contacts can comment on the video.\n * `nobody` - No one can comment on the video.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether a user can download the video. This field isn't available to Vimeo Free members."
}
}
},
"spatial": {
"type": "object",
"properties": {
"projection": {
"enum": [
"cubical",
"cylindrical",
"dome",
"equirectangular",
"pyramid"
],
"type": "string",
"description": "The 360 spatial projection.\n\nOption descriptions:\n * `cubical` - Use cubical projection.\n * `cylindrical` - Use cylindrical projection.\n * `dome` - Use dome projection.\n * `equirectangular` - Use equirectangular projection.\n * `pyramid` - Use pyramid projection.\n"
},
"field_of_view": {
"type": "number",
"example": 50,
"description": "The 360 field of view. This value must be between `30` and `90`; the default value is `50`."
},
"stereo_format": {
"enum": [
"left-right",
"mono",
"top-bottom"
],
"type": "string",
"description": "The 360 spatial stereo format.\n\nOption descriptions:\n * `left-right` - Use left-right stereo.\n * `mono` - Use monaural audio.\n * `top-bottom` - Use top-bottom stereo.\n"
},
"director_timeline": {
"type": "array",
"items": {
"type": "object",
"required": [
"pitch",
"time_code",
"yaw"
],
"properties": {
"yaw": {
"type": "number",
"example": 125,
"description": "The 360 director timeline yaw. This value must be between `0` and `360`, and it's required only when **spatial.director_timeline** is defined."
},
"roll": {
"type": "number",
"description": "The 360 director timeline roll."
},
"pitch": {
"type": "number",
"example": 70,
"description": "The 360 director timeline pitch. This value must be between `−90` and `90`, and it's required only when **spatial.director_timeline** is defined."
},
"time_code": {
"type": "number",
"example": 5,
"description": "The 360 director timeline time code. This field is required only when **spatial.director_timeline** is defined."
}
}
},
"description": "An array representing the 360 director timeline."
}
}
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The password. This field is required when **privacy.view** is `password`."
},
"folder_uri": {
"type": "string",
"example": "/users/12345/folders/6789",
"description": "The URI of the folder to which the video is uploaded."
},
"description": {
"type": "string",
"example": "A celebration of 10 years of Staff Picks.",
"description": "The description of the video."
},
"review_page": {
"type": "object",
"properties": {
"active": {
"type": "boolean",
"example": true,
"description": "Whether to enable video review."
}
}
},
"embed_domains": {
"type": "array",
"items": {
"type": "string"
},
"description": "The complete list of domains the video can be embedded on. This field requires that **privacy_embed** have the value `whitelist`."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of values describing the content in this video. For a full list of values, use the [`/contentratings`](https://developer.vimeo.com/api/reference/videos#get_content_ratings) endpoint."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether to hide the video from everyone except the video's owner. When the value is `true`, unlisted video links work only for the video's owner."
}
}
}
VideosVersionsAddVideoVersionRequest
{
"type": "object",
"required": [
"file_name",
"upload"
],
"properties": {
"upload": {
"type": "object",
"required": [
"approach"
],
"properties": {
"link": {
"type": "string",
"example": "https://example.com",
"description": "The public URL from which to download the version when **upload.approach** is `pull`. This URL must be valid for at least 24 hours."
},
"size": {
"type": "string",
"example": "13623861",
"description": "The upload size of the version."
},
"approach": {
"enum": [
"post",
"pull",
"tus"
],
"type": "string",
"description": "The approach by which to upload the version.\n\nOption descriptions:\n * `post` - Use the `post` method.\n * `pull` - Use the `pull` method.\n * `tus` - Use the `tus` method.\n"
},
"redirect_url": {
"type": "string",
"example": "https://example.com",
"description": "The app's redirect URL when **upload.approach** is `post`."
}
}
},
"file_name": {
"type": "string",
"example": "untitled.mp4",
"description": "The name of the version."
}
}
}
VideosVersionsEditVideoVersionRequest
{
"type": "object",
"properties": {
"is_current": {
"type": "boolean",
"example": true,
"description": "Whether the video version is active."
},
"description": {
"type": "string",
"example": "description with emoji",
"description": "A description of the video version. This description can make use of the full unicode character set."
}
}
}
VideosVersionsGetAllVideoVersions200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video-version"
}
}
VideosVersionsGetAllVideoVersionsResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video-version"
}
}
VideosVideoCommentsAddNewCommentRequest
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"example": "I love this!",
"description": "The text of the comment."
}
}
}
VideosVideoCommentsCreateReplyRequest
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"example": "I love this!",
"description": "The reply to the comment."
}
}
}
VideosVideoCommentsGetAllReplies200Response
{
"type": "array",
"items": {
"$ref": "#/components/schemas/comment"
}
}
VideosVideoCommentsGetAllRepliesResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/comment"
}
}
WatchLaterQueueEssentialsGetVideosInQueueResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
WatchLaterQueueEssentialsListUserQueueVideosResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/video"
}
}
WebinarEmailsCustomizePreferencesRequest
{
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar."
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos_2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar."
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar."
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address."
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar."
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address."
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar."
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar."
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts."
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails."
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts."
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts."
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration."
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows."
}
},
"description": "The preferences for emails that are sent about the webinar."
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy."
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar."
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar."
},
"email_post_event_thank_you": {
"type": "object",
"description": "The email customization details for the webinar post-event thank-you email."
},
"email_event_reminder_24_hrs": {
"type": "object",
"description": "The email customization details for the webinar reminder email, which goes out 24 hours before the event."
},
"email_registration_confirmation": {
"type": "object",
"description": "The email customization details for the webinar registration confirmation email."
}
}
}
WebinarEmailsCustomizePreferencesRequest1
{
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar."
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos_2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar."
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar."
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address."
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar."
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address."
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar."
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar."
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts."
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails."
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts."
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts."
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration."
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows."
}
},
"description": "The preferences for emails that are sent about the webinar."
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy."
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar."
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar."
},
"email_post_event_thank_you": {
"type": "object",
"description": "The email customization details for the webinar post-event thank-you email."
},
"email_event_reminder_24_hrs": {
"type": "object",
"description": "The email customization details for the webinar reminder email, which goes out 24 hours before the event."
},
"email_registration_confirmation": {
"type": "object",
"description": "The email customization details for the webinar registration confirmation email."
}
}
}
WebinarEssentialsCreateWebinarRequest
{
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"example": "Interviews Daily",
"description": "The title of the webinar."
},
"privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"password",
"team"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the webinar.\n\nOption descriptions:\n * `anybody` - Anyone can access the webinar. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - No one except the owner can access the webinar. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the event.\n * `team` - Only members of the authenticated user's team can access the webinar.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The initial embed privacy of the webinar.\n\nOption descriptions:\n * `private` - The webinar can't be embedded on any domain.\n * `public` - The webinar can be embedded on any domain.\n * `whitelist` - The webinar can be embedded on whitelisted domains only.\n"
}
},
"description": "The privacy settings of the webinar."
},
"password": {
"type": "string",
"example": "gogo",
"description": "The password when **privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the webinar event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the webinar is expected to be live.\n\nOption descriptions:\n * `single` - The webinar is live one time only.\n * `weekly` - The webinar is live on a weekly basis. _This field is deprecated._\n"
},
"end_time": {
"type": "string",
"example": "2019-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to end, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the webinar is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
}
},
"description": "Information about the time or times that the webinar is expected to be live."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in the automatically generated video titles for the webinar."
},
"folder_uri": {
"type": "number",
"example": 0,
"description": "The URI of the webinar's folder."
},
"description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the webinar."
},
"email_settings": {
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar. _This field is deprecated._"
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos_2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar. _This field is deprecated._"
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar. _This field is deprecated._"
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address. _This field is deprecated._"
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address. _This field is deprecated._"
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar. _This field is deprecated._"
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts. _This field is deprecated._"
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails. _This field is deprecated._"
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts. _This field is deprecated._"
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts. _This field is deprecated._"
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration. _This field is deprecated._"
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows. _This field is deprecated._"
}
},
"description": "The preferences for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy. _This field is deprecated._"
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar. _This field is deprecated._"
}
},
"description": "The settings for emails that are sent about the webinar. _This field is deprecated._"
}
}
}
WebinarEssentialsUpdateWebinarBelongingToAuthenticatedUserRequest
{
"type": "object",
"properties": {
"title": {
"type": "string",
"example": "Interviews Daily",
"description": "The title of the webinar."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"description": "The status of the webinar.\n\nOption descriptions:\n * `ended` - The webinar has ended.\n * `started` - The webinar has started.\n"
},
"privacy": {
"type": "object",
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"password",
"team"
],
"type": "string",
"example": "anybody",
"description": "The initial privacy of the webinar. This can't be updated once the webinar is in session.\n\nOption descriptions:\n * `anybody` - Anyone can access the webinar. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - No one except the owner can access the webinar. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the live event.\n * `team` - Only members of the authenticated user's team can access the webinar.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The initial embed privacy of the webinar.\n\nOption descriptions:\n * `private` - The webinar can't be embedded on any domain.\n * `public` - The webinar can be embedded on any domain.\n * `whitelist` - The webinar can be embedded on whitelisted domains only.\n"
}
},
"description": "The privacy settings of the webinar."
},
"password": {
"type": "string",
"example": "gogo",
"description": "The password when **privacy.view** is `password`. Anyone with the password can view the videos generated by streaming to the webinar event."
},
"schedule": {
"type": "object",
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "How often the webinar is expected to be live.\n\nOption descriptions:\n * `single` - The webinar is live one time only.\n * `weekly` - The webinar is live on a weekly basis. _This field is deprecated._\n"
},
"end_time": {
"type": "string",
"example": "2019-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to end, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "A non-empty array of weekdays on which the webinar is expected to be live. Weekdays can range from 1 to 7, where 1 is Monday and 7 is Sunday. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with the zero UTC offset `Z`. This parameter is required when **schedule.type** is `weekly`. _This field is deprecated._"
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the webinar is expected to be live, with support for different time offsets. This parameter is required when **schedule.type** is `single`."
}
},
"description": "Information about the time or times that the webinar is expected to be live. Please note that you can't update this setting once the webinar has started."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in the automatically generated video titles for the webinar."
},
"description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"description": "The description of the webinar."
},
"email_settings": {
"type": "object",
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar. _This field is deprecated._"
},
"logo_uri": {
"type": "string",
"example": "/users/123/team_logos/2343",
"description": "The URI of the logo image to include in emails that are sent about the webinar. _This field is deprecated._"
},
"custom_link": {
"type": "string",
"example": "https://xyz.com",
"description": "The custom link for emails that are sent about the webinar. _This field is deprecated._"
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"description": "The sender's reply email address. _This field is deprecated._"
},
"accent_color": {
"type": "string",
"example": "#000fff",
"description": "The accent color scheme for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"description": "The sender's physical address. _This field is deprecated._"
},
"use_custom_link": {
"type": "boolean",
"example": false,
"description": "Whether to include a custom link in emails that are sent about the webinar. _This field is deprecated._"
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"email_preferences": {
"type": "object",
"properties": {
"email_event_reminder_1_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 1 hour before the webinar starts. _This field is deprecated._"
},
"email_post_event_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails. _This field is deprecated._"
},
"email_event_reminder_15_min": {
"type": "boolean",
"description": "Whether to send a reminder email 15 minutes before the webinar starts. _This field is deprecated._"
},
"email_event_reminder_24_hrs": {
"type": "boolean",
"description": "Whether to send a reminder email 24 hours before the webinar starts. _This field is deprecated._"
},
"email_registration_confirmation": {
"type": "boolean",
"description": "Whether to send a registration confirmation email after webinar registration. _This field is deprecated._"
},
"email_post_event_no_show_thank_you": {
"type": "boolean",
"description": "Whether to send post-event thank-you emails to no-shows. _This field is deprecated._"
}
},
"description": "The preferences for emails that are sent about the webinar. _This field is deprecated._"
},
"sender_policy_url": {
"type": "string",
"example": "vimeo.com/policy",
"description": "The URL of the sender's privacy policy. _This field is deprecated._"
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar. _This field is deprecated._"
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar. _This field is deprecated._"
}
},
"description": "The settings for emails that are sent about the webinar. _This field is deprecated._"
}
}
}
WebinarRegistrationsCaptureUserRegistrationListRequest
{
"type": "object",
"properties": {
"registrants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "The registrant's other submitted fields."
},
"email": {
"type": "string",
"example": "jane.doe@vimeo.com",
"description": "The registrant's email address."
},
"last_name": {
"type": "string",
"example": "Doe",
"description": "The registrant's last name."
},
"first_name": {
"type": "string",
"example": "Jane",
"description": "The registrant's first name."
}
}
},
"description": "An array of registration data for the webinar."
}
}
}
WebinarRegistrationsCaptureUserRegistrationListRequest1
{
"type": "object",
"properties": {
"registrants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "The registrant's other submitted fields."
},
"email": {
"type": "string",
"example": "jane.doe@vimeo.com",
"description": "The registrant's email address."
},
"last_name": {
"type": "string",
"example": "Doe",
"description": "The registrant's last name."
},
"first_name": {
"type": "string",
"example": "Jane",
"description": "The registrant's first name."
}
}
},
"description": "An array of registration data for the webinar."
}
}
}
WebinarRegistrationsUpdateUserRegistrationDataRequest
{
"type": "object",
"properties": {
"is_blocked": {
"type": "boolean",
"example": true,
"description": "Whether to block the webinar registrant."
}
}
}
WebinarRegistrationsUpdateUserRegistrationDataRequest1
{
"type": "object",
"properties": {
"is_blocked": {
"type": "boolean",
"example": true,
"description": "Whether to block the webinar registrant."
}
}
}
activity-3-1
{
"type": "object",
"title": "Activity 3.1",
"required": [
"clip",
"metadata",
"time",
"type"
],
"properties": {
"tag": {
"$ref": "#/components/schemas/tag"
},
"clip": {
"$ref": "#/components/schemas/video"
},
"time": {
"type": "string",
"example": "2017-05-17T17:46:09+00:00",
"description": "The time that the event occurred."
},
"type": {
"enum": [
"appearance",
"category",
"channel",
"facebook_feed",
"group",
"like",
"ondemand",
"share",
"tag",
"twitter_timeline",
"upload"
],
"type": "string",
"example": "appearance",
"description": "The activity type.\n\nOption descriptions:\n * `appearance` - The activity is an appearance action.\n * `category` - The activity is a category action.\n * `channel` - The activity is a channel action.\n * `facebook_feed` - The activity is a Facebook feed action.\n * `group` - The activity is a group action.\n * `like` - The activity is a like action.\n * `ondemand` - The activity is a Vimeo On Demand action.\n * `share` - The activity is a share action.\n * `tag` - The activity is a tag action.\n * `twitter_timeline` - The activity is a Twitter timeline action.\n * `upload` - The activity is an upload action.\n"
},
"user": {
"$ref": "#/components/schemas/user"
},
"group": {
"$ref": "#/components/schemas/group"
},
"channel": {
"$ref": "#/components/schemas/channel"
},
"category": {
"$ref": "#/components/schemas/category"
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"related"
],
"properties": {
"related": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/activities?offset=20",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The activity's related content."
}
},
"description": "A list of resource URIs related to the activity."
}
},
"description": "Information about the activity's metadata."
}
},
"x-konfig-properties": {
"tag": {
"description": "The tag associated with the event. This field is present only when the activity type is `tag`."
},
"clip": {
"description": "The video associated with the activity."
},
"user": {
"description": "The user associated with the event. This field is present only when the activity type is `like`, `appearance`, or `share`."
},
"group": {
"description": "The group associated with the event. This field is present only when the activity type is `group`."
},
"channel": {
"description": "The channel associated with the event. This field is present only when the activity type is `channel`."
},
"category": {
"description": "The category associated with the event. This field is present only when the activity type is `category`."
}
}
}
album
{
"type": "object",
"title": "Album",
"required": [
"allow_continuous_play",
"allow_downloads",
"allow_share",
"autoplay",
"brand_color",
"created_time",
"custom_logo",
"description",
"domain",
"domain_certificate_state",
"duration",
"embed",
"embed_brand_color",
"embed_custom_logo",
"has_chosen_thumbnail",
"hide_from_vimeo",
"hide_nav",
"hide_upcoming",
"hide_vimeo_logo",
"layout",
"link",
"loop",
"metadata",
"modified_time",
"name",
"pictures",
"privacy",
"resource_key",
"review_mode",
"seo_allow_indexed",
"seo_description",
"seo_keywords",
"seo_title",
"share_link",
"sort",
"theme",
"unlisted_hash",
"uri",
"url",
"use_custom_domain",
"user",
"web_brand_color",
"web_custom_logo"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/albums/3706071",
"description": "The URI of the showcase."
},
"url": {
"type": "string",
"example": "my-custom-url",
"nullable": true,
"description": "The custom Vimeo URL of the showcase."
},
"link": {
"type": "string",
"example": "https://vimeo.com/showcase/Vimeo Holiday Videos!",
"description": "The URL of the showcase."
},
"loop": {
"type": "boolean",
"example": true,
"description": "Whether automatic playback restarts at the top of the showcase's embedded playlist after reaching the end of the last video in the playlist."
},
"name": {
"type": "string",
"example": "Vimeo Holiday Videos!",
"description": "The display name of the showcase."
},
"sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The sort order of the showcase.\n\nOption descriptions:\n * `added_first` - Sort the showcase videos in order of those most recently added.\n * `added_last` - Sort the showcase videos in order of those least recently added.\n * `alphabetical` - Sort the showcase videos alphabetically.\n * `arranged` - Sort the showcase videos according to their custom arrangement.\n * `comments` - Sort the showcase videos by number of comments.\n * `likes` - Sort the showcase videos by number of likes.\n * `newest` - Sort the showcase videos in order of creation date with the newest first.\n * `oldest` - Sort the showcase videos in order of creation date with the oldest first.\n * `plays` - Sort the showcase videos by number of plays.\n"
},
"user": {
"$ref": "#/components/schemas/user"
},
"embed": {
"type": "object",
"required": [
"html"
],
"properties": {
"html": {
"type": "string",
"nullable": true,
"description": "The responsive HTML code to embed the showcase's playlist on a website. This field appears only when the showcase has embeddable videos."
}
},
"description": "Embed data for the showcase."
},
"theme": {
"enum": [
"dark",
"standard"
],
"type": "string",
"example": "dark",
"description": "The color theme of the showcase.\n\nOption descriptions:\n * `dark` - The showcase uses the dark theme.\n * `standard` - The showcase uses the standard theme.\n"
},
"domain": {
"type": "string",
"example": "mycustomdomain.com",
"nullable": true,
"description": "The custom domain of the showcase."
},
"layout": {
"enum": [
"grid",
"player"
],
"type": "string",
"example": "grid",
"description": "The type of layout for presenting the showcase.\n\nOption descriptions:\n * `grid` - The showcase videos appear in a grid.\n * `player` - The showcase videos appear in the player.\n"
},
"privacy": {
"type": "object",
"required": [
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"team",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The access level of the showcase.\n\nOption descriptions:\n * `anybody` - Anyone can access the showcase. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The showcase doesn't appear on Vimeo, but the owner can embed it on other sites.\n * `nobody` - No one can access the showacse, including the owner. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the showcase.\n * `team` - Only the owner and members of the owner's team can access the showcase.\n * `unlisted` - The showcase can't be accessed if the URL omits its unlisted hash.\n"
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The showcase's password. This field appears only when **privacy.view** is `password`."
}
},
"description": "The privacy settings of the showcase."
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether to start playback of the next video in the showcase's embedded playlist immediately after the previous video finishes."
},
"duration": {
"type": "number",
"example": 1163,
"description": "The total duration in seconds of all the videos in the showcase."
},
"hide_nav": {
"type": "boolean",
"example": true,
"description": "Whether to hide Vimeo navigation when displaying the showcase."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"available_videos",
"requested_clip",
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/albums/3706071/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to the showcase."
},
"requested_clip": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "videos/1232",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the requested video."
},
"available_videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/albums/3706071/available_videos",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 14,
"description": "The total number of videos on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the authenticated user's videos that can be added to or removed from this showcase. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about showcase connections."
},
"interactions": {
"type": "object",
"nullable": true,
"required": [
"add_custom_thumbnails",
"add_live_events",
"add_logos",
"add_to",
"add_videos",
"delete",
"edit",
"invite",
"view_privacy"
],
"properties": {
"edit": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit a showcase."
},
"add_to": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/albums/1234/videos/5678",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about adding or removing a video from the showcase. This data requires a bearer token with the `private` scope."
},
"delete": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to delete a showcase."
},
"invite": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to invite a team member to a showcase."
},
"add_logos": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456/albums/654321/logos",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is an administrator of the showcase and may therefore add custom logos. This data requires a bearer token with the `private` scope."
},
"add_videos": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456/albums/654321/videos",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is an administrator of the showcase and may therefore add videos. This data requires a bearer token with the `private` scope."
},
"view_privacy": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about whether a user has permissions to view the privacy of the showcase."
},
"add_live_events": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456/albums/654321/live_events",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is an administrator of the showcase and may therefore add events. This data requires a bearer token with the `private` scope."
},
"add_custom_thumbnails": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456/albums/654321/custom_thumbnails",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is an administrator of the showcase and may therefore add custom thumbnails. This data requires a bearer token with the `private` scope."
}
},
"description": "A list of resource URIs related to the showcase."
}
},
"description": "Metadata about the showcase."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"seo_title": {
"type": "string",
"nullable": true,
"description": "The SEO title of the showcase."
},
"share_link": {
"type": "string",
"description": "The URL for sharing the showcase."
},
"allow_share": {
"type": "boolean",
"example": true,
"description": "Whether the showcase permits sharing."
},
"brand_color": {
"type": "string",
"example": "ff66ee",
"nullable": true,
"description": "The hexadecimal code for the color of the player buttons and showcase controls."
},
"custom_logo": {
"allOf": [
{
"$ref": "#/components/schemas/picture"
}
],
"nullable": true,
"description": "The custom logo of the showcase."
},
"description": {
"type": "string",
"example": "Vimeo holiday videos!",
"nullable": true,
"description": "A brief description of the showcase's content."
},
"review_mode": {
"type": "boolean",
"example": true,
"description": "Whether showcase videos use the review mode URL."
},
"created_time": {
"type": "string",
"example": "2015-12-17T21:32:44+00:00",
"description": "The time in ISO 8601 format when the showcase was created."
},
"resource_key": {
"type": "string",
"example": "e5595241643259c658ed6c85ca82985a6341edc7",
"description": "The resource key of the showcase."
},
"seo_keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "The SEO keywords of the showcase."
},
"hide_upcoming": {
"type": "boolean",
"example": false,
"description": "Whether to include the upcoming event in the showcase."
},
"modified_time": {
"type": "string",
"example": "2018-02-06T21:24:17+00:00",
"description": "The time in ISO 8601 format when the showcase was last modified."
},
"unlisted_hash": {
"type": "string",
"description": "The unlisted hash of the showcase. Omit this hash from the showcase URL to prevent access to the showcase on Vimeo."
},
"allow_downloads": {
"type": "boolean",
"example": true,
"description": "Whether the showcase permits downloads."
},
"hide_from_vimeo": {
"type": "boolean",
"example": false,
"description": "Whether the showcase should be hidden from Vimeo when unlisted."
},
"hide_vimeo_logo": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether to hide the Vimeo logo in the player of the showcase's embedded playlist."
},
"seo_description": {
"type": "string",
"nullable": true,
"description": "The SEO description of the showcase."
},
"web_brand_color": {
"type": "boolean",
"example": true,
"description": "Whether to use the showcase's brand color in the web layout."
},
"web_custom_logo": {
"type": "boolean",
"example": true,
"description": "Whether to use the showcase's custom logo in the web layout."
},
"embed_brand_color": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether to show the showcase's custom brand color in the player of the showcase's embedded playlist."
},
"embed_custom_logo": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether to show the showcase's custom logo in the player of the showcase's embedded playlist."
},
"seo_allow_indexed": {
"type": "boolean",
"example": false,
"description": "Whether search engines can index the showcase."
},
"use_custom_domain": {
"type": "boolean",
"example": false,
"description": "Whether the showcase uses a custom domain."
},
"has_chosen_thumbnail": {
"type": "boolean",
"example": true,
"description": "Whether the showcase has a thumbnail."
},
"allow_continuous_play": {
"type": "boolean",
"example": true,
"description": "Whether the showcase permits continuous play."
},
"domain_certificate_state": {
"enum": [
"null",
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8"
],
"type": "string",
"example": "null",
"description": "The state of the SSL certificate that is associated with the showcase's domain.\n\nOption descriptions:\n * `null` - There is no associated HTTPS domain with this showcase.\n * `0` - The new certificate has yet to be processed.\n * `1` - The new certificate is being processed in the queue.\n * `2` - The certificate is being processed for renewal in the queue.\n * `3` - The new certificate has failed to be issued in the queue.\n * `4` - The certificate has failed to be renewed in the queue.\n * `5` - The certificate has been successfully issued.\n * `6` - The certificate has been successfully renewed.\n * `7` - The certificate has failed in the polling flow.\n * `8` - The certificate has failed to be renewed in the polling flow.\n"
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the showcase."
},
"pictures": {
"description": "The active image of the showcase."
}
}
}
analytics
{
"type": "object",
"title": "Analytics",
"required": [
"average_percent_watched",
"average_time_watched",
"country",
"device_type",
"downloads",
"embed_domain",
"end_date",
"finishes",
"impressions",
"metadata",
"start_date",
"total_time_watched",
"unique_impressions",
"unique_viewers",
"views"
],
"properties": {
"views": {
"type": "number",
"example": 1,
"description": "The number of views of the corresponding Vimeo content."
},
"country": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"example": "US",
"description": "The country code in ISO-3166 format."
},
"name": {
"type": "string",
"example": "United States",
"description": "The name of the country."
}
}
},
"end_date": {
"type": "string",
"example": "2023-11-06T21:04:47+00:00",
"description": "The end time of the time interval in ISO 8601 format."
},
"finishes": {
"type": "number",
"example": 1,
"description": "The number of finishes of the corresponding Vimeo content."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"video"
],
"properties": {
"video": {
"type": "object",
"required": [
"created_time",
"duration",
"manage_link",
"options",
"title",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/152184",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"title": {
"type": "string",
"description": "The title of the associated video. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
},
"duration": {
"type": "number",
"description": "The duration of the associated video. This data requires a bearer token with the `private` scope."
},
"manage_link": {
"type": "string",
"example": "/manage/videos/258684937",
"description": "The link to the video management page. This data requires a bearer token with the `private` scope."
},
"created_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the video was created. This data requires a bearer token with the `private` scope."
}
},
"description": "The associated video object. This data requires a bearer token with the `private` scope."
}
}
}
}
},
"downloads": {
"type": "number",
"example": 1,
"description": "The number of downloads of the corresponding Vimeo content."
},
"start_date": {
"type": "string",
"example": "2023-11-05T21:04:47+00:00",
"description": "The start time of the time interval in ISO 8601 format."
},
"device_type": {
"type": "string",
"example": "Desktop",
"description": "The type of device."
},
"impressions": {
"type": "number",
"example": 1,
"description": "The number of impressions of the corresponding Vimeo content."
},
"embed_domain": {
"type": "string",
"example": "vimeo.com",
"description": "The domain name of the website."
},
"unique_viewers": {
"type": "number",
"example": 1,
"description": "The number of unique viewers of the corresponding Vimeo content."
},
"total_time_watched": {
"type": "number",
"example": 200,
"description": "The total time watched in seconds of the corresponding Vimeo content."
},
"unique_impressions": {
"type": "number",
"example": 1,
"description": "The number of unique impressions of the corresponding Vimeo content."
},
"average_time_watched": {
"type": "number",
"example": 200,
"description": "The average time watched in seconds of the corresponding Vimeo content."
},
"average_percent_watched": {
"type": "number",
"example": 50,
"description": "The average percent watched in seconds of the corresponding Vimeo content."
}
}
}
ancestor-path
{
"type": "object",
"title": "Ancestor Path",
"required": [
"link",
"name"
],
"properties": {
"link": {
"type": "string",
"description": "The link to the folder."
},
"name": {
"type": "string",
"description": "The name of the folder."
}
}
}
animated-thumbnail
{
"type": "object",
"title": "Animated Thumbnail",
"required": [
"duration",
"file_format",
"file_size",
"height",
"is_downloadable",
"link",
"link_with_play_button",
"profile_id",
"start_time",
"uuid",
"width"
],
"properties": {
"link": {
"type": "string",
"example": "https://videoapi-muybridge-dev.vimeocdn.com/animated-thumbnails/image/7005be96-e5ab-4c4c-9cdd-8b6dfc2b304",
"description": "The URL of the animated thumbnail file."
},
"uuid": {
"type": "string",
"example": "b2f1-711515ecf",
"description": "The ID of the animated thumbnail."
},
"width": {
"type": "number",
"example": 800,
"description": "The width of the animated thumbnail in pixels."
},
"height": {
"type": "number",
"example": 450,
"description": "The height of the animated thumbnail in pixels."
},
"duration": {
"type": "number",
"example": 4,
"description": "The duration of the animated thumbnail in seconds."
},
"file_size": {
"type": "number",
"example": 1440000,
"description": "The file size of the animated thumbnail in bytes."
},
"profile_id": {
"type": "string",
"example": "Low",
"description": "The profile ID of the animated thumbnail."
},
"start_time": {
"type": "number",
"example": 0,
"description": "The time in the video, in seconds, corresponding to the start of the animation."
},
"file_format": {
"type": "string",
"example": "gif",
"description": "The file format of the animated thumbnail."
},
"is_downloadable": {
"type": "boolean",
"example": true,
"description": "Whether the animated thumbnail can be downloaded."
},
"link_with_play_button": {
"type": "string",
"example": "https://videoapi-muybridge-dev.vimeocdn.com/animated-thumbnails/image/7005be96-e5ab-4c4c-9cdd-8b6dfc2b304",
"description": "The URL of the animated thumbnail file with a play button overlay."
}
}
}
animated-thumbset
{
"type": "object",
"title": "Animated Thumbset",
"required": [
"clip_uri",
"created_on",
"sizes",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/234/animated_thumbsets/ww-4c4c-9cdd",
"description": "The URI of the set of animated thumbnails."
},
"sizes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/animated-thumbnail"
},
"description": "An array of all the animated thumbnails in the set."
},
"status": {
"enum": [
"cancelled",
"completed",
"failed",
"started"
],
"type": "string",
"example": "cancelled",
"description": "The availability of the animated thumbnail.\n\nOption descriptions:\n * `cancelled` - The animated thumbnail's creation has been cancelled.\n * `completed` - The animated thumbnail has been created.\n * `failed` - The animated thumbnail's creation has failed.\n * `started` - The animated thumbnail's creation has started.\n"
},
"clip_uri": {
"type": "string",
"example": "/videos/23456",
"description": "The URI of the video from which the sets of animated thumbnails were created."
},
"created_on": {
"type": "string",
"example": "1494888499",
"description": "The time in ISO 8601 format when the GIF was created."
}
}
}
api-app
{
"type": "object",
"title": "API App",
"required": [
"capabilities",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/apps/12345",
"description": "The canonical URI of the API app."
},
"name": {
"type": "string",
"example": "Vimeo Android",
"description": "The name of the API app."
},
"capabilities": {
"type": "object",
"description": "The app's capabilities list."
}
}
}
auth
{
"type": "object",
"title": "Auth",
"required": [
"access_token",
"app",
"scope",
"token_type"
],
"properties": {
"app": {
"$ref": "#/components/schemas/api-app"
},
"user": {
"$ref": "#/components/schemas/user"
},
"scope": {
"type": "string",
"example": "private create edit upload public",
"description": "The scope or scopes that the token supports."
},
"expires_on": {
"type": "string",
"example": "1495048954",
"description": "The token's expiration date."
},
"token_type": {
"enum": [
"bearer"
],
"type": "string",
"example": "bearer",
"description": "The token type.\n\nOption descriptions:\n * `bearer` - The token is of the `bearer` type.\n"
},
"access_token": {
"type": "string",
"example": "01019a4a62aec63db077317ab7bb429db75652401e",
"description": "The access token string."
},
"refresh_token": {
"type": "string",
"example": "3d3bc8a9cb7debfd01b270e419b2d265983362f9",
"description": "The refresh token string. The Vimeo API doesn't currently support refresh tokens, but we plan to add this support in the future."
}
},
"x-konfig-properties": {
"app": {
"description": "The API application associated with the token."
},
"user": {
"description": "The user associated with the token."
}
}
}
auth-error
{
"type": "object",
"title": "Auth Error",
"required": [
"error",
"error_description"
],
"properties": {
"error": {
"type": "string",
"example": "server_error",
"description": "The name of the error."
},
"error_description": {
"type": "string",
"example": "An error has occurred on Vimeo's servers. Please try again.",
"description": "The description of the error."
}
}
}
category
{
"type": "object",
"title": "Category",
"required": [
"is_deprecated",
"last_video_featured_time",
"link",
"metadata",
"name",
"parent",
"pictures",
"resource_key",
"top_level",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation",
"description": "The unique identifier to access the category resource."
},
"icon": {
"$ref": "#/components/schemas/picture"
},
"link": {
"type": "string",
"example": "https://vimeo.com/categories/animation",
"description": "The URL to access the category in a browser."
},
"name": {
"type": "string",
"example": "Animation",
"description": "The display name that identifies the category."
},
"parent": {
"type": "object",
"nullable": true,
"required": [
"link",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation",
"description": "The unique identifier to access the parent of the category resource."
},
"link": {
"type": "string",
"example": "https://vimeo.com/categories/animation",
"description": "The URL to access the parent category in a browser."
},
"name": {
"type": "string",
"example": "Animation",
"description": "The display name that identifies the parent category."
}
},
"description": "The container of the category's parent category, if the current category is a subcategory."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"channels",
"groups",
"users",
"videos"
],
"properties": {
"users": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 140,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the users related to this category."
},
"groups": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation/groups",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 15,
"description": "The total number of groups on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the groups related to this category."
},
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 960,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos related to this category."
},
"channels": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation/channels",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 90,
"description": "The total number of channels on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the channels related to this category."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"required": [
"follow"
],
"properties": {
"follow": {
"type": "object",
"required": [
"added",
"added_time",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/categories/animation",
"description": "The URI for following or unfollowing the category: PUT to this URI to follow the category, or DELETE to this URI to unfollow the category."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user has followed the category."
},
"added_time": {
"type": "string",
"example": "2017-05-17T17:46:09+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the user followed the category, or the null value if the user hasn't followed the category."
}
},
"description": "An action indicating if the authenticated user has followed the category."
}
},
"description": "The permissible actions related to the category."
}
},
"description": "Metadata about the category."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"top_level": {
"type": "boolean",
"example": true,
"description": "Whether the category isn't a subcategory of another category."
},
"resource_key": {
"type": "string",
"example": "e5595241643259c658ed6c85ca82985a6341edc7",
"description": "The resource key of the category."
},
"is_deprecated": {
"type": "boolean",
"example": false,
"description": "Whether the category is deprecated and should not be used for new categorization."
},
"subcategories": {
"type": "array",
"items": {
"type": "object",
"required": [
"link",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/categories/animation/subcategories/2d",
"description": "The unique identifier to access the subcategory. resource."
},
"link": {
"type": "string",
"example": "https://vimeo.com/categories/animation/2d/videos",
"description": "The URL to access the subcategory in a browser."
},
"name": {
"type": "string",
"example": "2D",
"description": "The display name that identifies the subcategory."
}
}
},
"description": "All the subcategories that belong to the category, if the current category is a top-level parent."
},
"last_video_featured_time": {
"type": "string",
"example": "2017-05-17T17:46:09+00:00",
"description": "The most recent time in ISO 8601 format when the video was featured."
}
},
"x-konfig-properties": {
"icon": {
"description": "The active icon for the category."
},
"pictures": {
"description": "The active picture for this category. The default shows vertical color bars."
}
}
}
channel
{
"type": "object",
"title": "Channel",
"required": [
"categories",
"created_time",
"description",
"header",
"link",
"metadata",
"modified_time",
"name",
"pictures",
"privacy",
"resource_key",
"tags",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/927",
"description": "The unique identifier to access the channel resource."
},
"link": {
"type": "string",
"example": "https://vimeo.com/channels/staffpicks",
"description": "The URL to access the channel in a browser."
},
"name": {
"type": "string",
"example": "Vimeo Staff Picks",
"description": "The display name that identifies the channel."
},
"tags": {
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
},
"description": "An array of all tags assigned to the channel."
},
"user": {
"$ref": "#/components/schemas/user"
},
"header": {
"$ref": "#/components/schemas/picture"
},
"privacy": {
"type": "object",
"required": [
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"moderators",
"users"
],
"type": "string",
"example": "anybody",
"description": "The privacy setting of the channel.\n\nOption descriptions:\n * `anybody` - Anyone can access the channel. This privacy setting appears as `Public` on the Vimeo front end.\n * `moderators` - Only moderators can access the channel.\n * `users` - Only registered users can access the channel. _This field is deprecated._\n"
}
},
"description": "The privacy settings of the channel."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"privacy_users",
"users",
"videos"
],
"properties": {
"users": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/927/users",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 794634,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the users following or moderating this channel."
},
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/927/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12448,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to this channel."
},
"privacy_users": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/927/privacy/users",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 36,
"description": "The total number of users on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information provided to channel moderators about which users they have specifically permitted to access this private channel. This data requires a bearer token with the `private` scope."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"nullable": true,
"required": [
"add_moderators",
"add_to",
"follow",
"moderate_videos"
],
"properties": {
"add_to": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/1234/videos/5678",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "When a channel appears in the context of adding or removing a video from it (`/videos/{video_id}/available_channels`), include information about adding or removing the video. This data requires a bearer token with the `private` scope."
},
"follow": {
"type": "object",
"required": [
"added",
"added_time",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/1234/channels/927",
"description": "The URI for following or unfollowing this channel. PUT to this URI to follow the channel, or DELETE to this URI to unfollow the channel. This data requires a bearer token with the `private` scope."
},
"type": {
"enum": [
"moderator",
"subscriber"
],
"type": "string",
"example": "moderator",
"nullable": true,
"description": "Whether the authenticated user is a moderator or subscriber. This data requires a bearer token with the `private` scope.\n\nOption descriptions:\n * `moderator` - The authenticated user is a moderator.\n * `subscriber` - The authenticated user is a subscriber.\n"
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user has followed this channel. This data requires a bearer token with the `private` scope."
},
"added_time": {
"type": "string",
"example": "2017-05-22T17:50:11+00:00",
"nullable": true,
"description": "The time in ISO 8601 format that the user followed this channel, or the null value if the user hasn't followed the channel. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating if the authenticated user has followed this channel. This data requires a bearer token with the `private` scope."
},
"add_moderators": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/1234/moderators",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is the owner of the channel and may therefore add other users as channel moderators. This data requires a bearer token with the `private` scope."
},
"moderate_videos": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/channels/1234/videos",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods allowed on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that the authenticated user is a moderator of the channel and may therefore add or remove videos from the channel. This data requires a bearer token with the `private` scope."
}
},
"description": "A list of resource URIs related to the channel."
}
},
"description": "Metadata about the channel."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"categories": {
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
},
"description": "The categories to which the channel belongs as specified by the channel moderators."
},
"description": {
"type": "string",
"example": "We really love videos, and these are the videos we really, really love.",
"nullable": true,
"description": "A brief explanation of the channel's content."
},
"created_time": {
"type": "string",
"example": "2007-10-23T17:00:43+00:00",
"description": "The time in ISO 8601 format when the channel was created."
},
"resource_key": {
"type": "string",
"example": "e5595241643259c658ed6c85ca82985a6341edc7",
"description": "The channel resource key."
},
"modified_time": {
"type": "string",
"example": "2018-03-21T22:52:29+00:00",
"description": "The time in ISO 8601 format when the channel was last modified."
}
},
"x-konfig-properties": {
"user": {
"description": "The Vimeo user who owns the channel."
},
"header": {
"description": "The banner that appears by default at the top of the channel page."
},
"pictures": {
"description": "The active image for the channel. The default is the thumbnail of the last video added to the channel."
}
}
}
chapter
{
"type": "object",
"title": "Chapter",
"required": [
"thumbnails",
"timecode",
"title",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/chapters/12345",
"description": "The relative URI of the chapter."
},
"title": {
"type": "string",
"example": "Chapter 1",
"nullable": true,
"description": "The title of the chapter."
},
"timecode": {
"type": "number",
"example": 140,
"nullable": true,
"description": "The timecode of the chapter in seconds from the start of the video."
},
"thumbnails": {
"type": "array",
"items": {
"$ref": "#/components/schemas/picture"
},
"description": "The thumbnails associated with the video chapter."
},
"active_thumbnail_uri": {
"type": "string",
"example": "/videos/12345678/chapters/12345/pictures/24kjh4h4g38175db9f59fae9f7g9ekhg",
"description": "The URI of the active thumbnail."
}
}
}
comment
{
"type": "object",
"title": "Comment",
"required": [
"created_on",
"link",
"metadata",
"replies",
"resource_key",
"text",
"type",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/comments/12345",
"description": "The unique identifier to access the comment resource."
},
"link": {
"type": "string",
"example": "https://vimeo.com/258684937#comment_12345",
"description": "The permalink to the comment."
},
"text": {
"type": "string",
"example": "I love this!",
"description": "The content of the comment."
},
"type": {
"enum": [
"video"
],
"type": "string",
"example": "video",
"description": "The Vimeo content to which the comment relates.\n\nOption descriptions:\n * `video` - The comment is about a video.\n"
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The user who posted the comment. _This field is deprecated. Use the `metadata.connections.user` field instead._"
},
"replies": {
"type": "array",
"items": {
"$ref": "#/components/schemas/reply"
},
"description": "The list of replies to the comment."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"replies",
"user"
],
"properties": {
"user": {
"type": "object",
"required": [
"link",
"name",
"pictures",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The unique identifier to access the user resource."
},
"link": {
"type": "string",
"description": "The absolute URL of the authenticated users's profile page."
},
"name": {
"type": "string",
"description": "The display name of the user who posted the reply."
},
"pictures": {
"$ref": "#/components/schemas/picture"
}
},
"description": "Information about the user who posted the reply.",
"x-konfig-properties": {
"pictures": {
"description": "Information about the user's portraits."
}
}
},
"replies": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/comments/12345/replies",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 42,
"description": "The total number of replies on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the replies to the comment."
}
}
}
}
},
"created_on": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the comment was posted."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The comment's resource key string."
}
}
}
content-rating
{
"type": "object",
"title": "Content Rating",
"required": [
"code",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/contentrating/violence",
"nullable": true,
"description": "The canonical relative URI of the content rating."
},
"code": {
"enum": [
"advertisement",
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "string",
"example": "violence",
"description": "The reason for the content rating.\n\nOption descriptions:\n * `advertisement` - The content contains an advertisement.\n * `drugs` - The content contains drug or alcohol use.\n * `language` - The content contains profanity or sexually suggestive language.\n * `nudity` - The content contains nudity.\n * `safe` - The content is suitable for all audiences.\n * `unrated` - The content hasn't been rated.\n * `violence` - The content contains violence or is graphic.\n"
},
"name": {
"type": "string",
"example": "Violence",
"description": "The name of the content rating."
}
}
}
creative-commons
{
"type": "object",
"title": "Creative Commons",
"required": [
"code",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/creativecommons/by-sa",
"nullable": true,
"description": "The canonical relative URI of the Creative Commons license."
},
"code": {
"enum": [
"by",
"by-nc",
"by-nc-nd",
"by-nc-sa",
"by-nd",
"by-sa",
"cc0"
],
"type": "string",
"example": "by-sa",
"description": "The type of Creative Commons license.\n\nOption descriptions:\n * `by` - Attribution.\n * `by-nc` - Attribution Non-Commercial.\n * `by-nc-nd` - Attribution Non-Commercial No Derivatives.\n * `by-nc-sa` - Attribution Non-Commercial Share Alike.\n * `by-nd` - Attribution No Derivatives.\n * `by-sa` - Attribution Share Alike.\n * `cc0` - Public Domain Dedication.\n"
},
"name": {
"type": "string",
"example": "Attribution Share Alike",
"description": "The description of the Creative Commons license."
}
}
}
credit
{
"type": "object",
"title": "Credit",
"required": [
"name",
"role",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/credits/1234",
"description": "The unique identifier to access the credit resource."
},
"name": {
"type": "string",
"example": "Sam Doe",
"description": "The name of the person credited."
},
"role": {
"type": "string",
"example": "Themselves",
"description": "The character that the person portrayed, or the job that the person performed."
},
"user": {
"$ref": "#/components/schemas/user"
},
"video": {
"$ref": "#/components/schemas/video"
}
},
"x-konfig-properties": {
"user": {
"description": "The Vimeo user associated with the credit."
},
"video": {
"description": "The video associated with the credit."
}
}
}
domain
{
"type": "object",
"title": "Domain",
"required": [
"allow_hd",
"domain",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/privacy/domains/example.com",
"description": "The URI of the domain."
},
"domain": {
"type": "string",
"example": "example.com",
"description": "The domain name."
},
"allow_hd": {
"type": "boolean",
"example": true,
"description": "Whether to permit HD embeds on this domain."
}
}
}
editing-session
{
"type": "object",
"title": "Editing Session",
"required": [
"has_watermark",
"is_edited_by_tve",
"is_max_resolution",
"is_music_licensed",
"is_rated",
"min_tier_for_movie",
"result_video_hash",
"status",
"vsid"
],
"properties": {
"vsid": {
"type": "number",
"description": "The ID of the video's editing session."
},
"status": {
"enum": [
"done",
"processing"
],
"type": "string",
"example": "done",
"description": "The status of the video.\n\nOption descriptions:\n * `done` - The video is finished processing.\n * `processing` - The video is still being processed.\n"
},
"is_rated": {
"type": "boolean",
"example": false,
"description": "Whether the video has been rated."
},
"version_uri": {
"type": "string",
"example": "/videos/258684937/versions/12345",
"description": "The version's canonical relative URI."
},
"has_watermark": {
"type": "boolean",
"description": "Whether the video has a watermark."
},
"is_edited_by_tve": {
"type": "boolean",
"description": "Whether the video has been edited by Transcript Video Editing."
},
"is_max_resolution": {
"type": "boolean",
"description": "Whether the current version of the video is at the maximum resolution."
},
"is_music_licensed": {
"type": "boolean",
"description": "Whether the video has licensed music."
},
"result_video_hash": {
"type": "string",
"description": "The result video hash for the created video."
},
"min_tier_for_movie": {
"type": "string",
"description": "The minimum required Vimeo membership for the user to be able to share the video."
}
}
}
email-capture-form
{
"type": "object",
"title": "Email Capture Form",
"required": [
"clip_id",
"created_time",
"custom_fields",
"custom_logo",
"custom_message",
"email_lists",
"hidden_fields",
"id",
"position",
"privacy_policy",
"skippable",
"timecode",
"uri"
],
"properties": {
"id": {
"type": "number",
"example": 52845,
"description": "The ID of the email capture form."
},
"uri": {
"type": "string",
"example": "/clip_email_capture_form/52845",
"description": "The canonical relative URI of the video's email capture form."
},
"clip_id": {
"type": "number",
"example": 76979871,
"description": "The ID of the video associated with the form. If there is no associated video, the value of this field is `-1`."
},
"position": {
"enum": [
"after-video",
"before-video",
"during-video"
],
"type": "string",
"example": "before-video",
"description": "When the form appears relative to the video playback.\n\nOption descriptions:\n * `after-video` - The form appears immediately after the video ends.\n * `before-video` - The form appears before the video begins.\n * `during-video` - The form appears during the video at the time specified by the **timecode** field.\n"
},
"timecode": {
"type": "string",
"example": "00:00",
"description": "The timecode for when the form appears. This field is used when the value of **position** is `during-video`."
},
"skippable": {
"type": "boolean",
"example": true,
"description": "Whether the user can skip the form."
},
"custom_logo": {
"type": "number",
"example": 532603,
"description": "The ID of the logo image to display on the form."
},
"email_lists": {
"type": "array",
"items": {
"type": "object",
"required": [
"form_id",
"list_id",
"provider_id"
],
"properties": {
"form_id": {
"type": "number",
"description": "The ID of the email capture form."
},
"list_id": {
"type": "string",
"description": "The ID of the mailing list in the third-party email service provider's system."
},
"list_name": {
"type": "string",
"description": "The name of the mailing list in the third-party email service provider's system."
},
"provider_id": {
"enum": [
1,
2,
3,
4,
5,
6,
7
],
"type": "integer",
"example": 1,
"description": "A third-party email service provider.\n\nOption descriptions:\n * `1` - The provider is Mailchimp.\n * `2` - The provider is Campaign Monitor.\n * `3` - The provider is Constant Contact.\n * `4` - The provider is Infusionsoft.\n * `5` - The provider is HubSpot.\n * `6` - The provider is Constant Contact V3.\n * `7` - The provider is Marketo.\n"
}
}
},
"description": "The mailing lists on a third-party email service provider that submissions should get synced to."
},
"created_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the form was created."
},
"custom_fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"connected_fields",
"field_metadata",
"field_name",
"field_type",
"locked",
"required",
"static_field"
],
"properties": {
"locked": {
"type": "boolean",
"description": "Whether the field's **required** property is editable but **field_name** isn't. If the value is `true`, the field can't be deleted."
},
"required": {
"type": "boolean",
"description": "Whether the field is required."
},
"field_name": {
"type": "string",
"description": "The name of a field in the form."
},
"field_type": {
"enum": [
"dropdown",
"text"
],
"type": "string",
"example": "dropdown",
"description": "The type of custom field.\n\nOption descriptions:\n * `dropdown` - The custom field used for dropdown item selection.\n * `text` - The custom field used for text input.\n"
},
"static_field": {
"type": "boolean",
"description": "Whether the field's **required** and **field_name** properties are both uneditable. If the value is `true`, the field can't be deleted."
},
"field_metadata": {
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"option_label",
"option_position"
],
"properties": {
"option_label": {
"type": "string",
"description": "The label for the field option."
},
"option_position": {
"type": "number",
"description": "The position of the option in the dropdown relative to the others."
}
}
},
"description": "An array of options associated with the field."
}
},
"description": "The metadata object that is associated with the field in the form."
},
"connected_fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"email_service_provider_field_id",
"form_field_id",
"provider_id"
],
"properties": {
"provider_id": {
"enum": [
1,
2,
3,
4,
5,
6,
7
],
"type": "integer",
"example": 1,
"description": "A third-party email service provider.\n\nOption descriptions:\n * `1` - The provider is Mailchimp.\n * `2` - The provider is Campaign Monitor.\n * `3` - The provider is Constant Contact.\n * `4` - The provider is Infusionsoft.\n * `5` - The provider is HubSpot.\n * `6` - The provider is Constant Contact V3.\n * `7` - The provider is Marketo.\n"
},
"form_field_id": {
"type": "number",
"description": "The ID of the field in the form associated with the connected field."
},
"email_service_provider_field_id": {
"type": "string",
"description": "The ID of the provider field."
}
}
},
"description": "The email provider fields associated with the field in the form."
}
}
},
"description": "The fields to show in the form."
},
"hidden_fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"connected_fields",
"field_metadata",
"field_name",
"field_type",
"locked",
"required",
"static_field"
],
"properties": {
"locked": {
"type": "boolean",
"description": "Whether the field's **required** property is editable but **field_name** isn't. If the value is `true`, the field can't be deleted."
},
"required": {
"type": "boolean",
"description": "Whether the field is required."
},
"field_name": {
"type": "string",
"description": "The name of a field in the form."
},
"field_type": {
"enum": [
"dropdown",
"text"
],
"type": "string",
"example": "dropdown",
"description": "The type of custom field.\n\nOption descriptions:\n * `dropdown` - The custom field used for dropdown item selection.\n * `text` - The custom field used for text input.\n"
},
"static_field": {
"type": "boolean",
"description": "Whether the field's **required** and **field_name** properties are both uneditable. If the value is `true`, the field can't be deleted."
},
"field_metadata": {
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"option_label",
"option_position"
],
"properties": {
"option_label": {
"type": "string",
"description": "The label for the field option."
},
"option_position": {
"type": "number",
"description": "The position of the option in the dropdown relative to the others."
}
}
},
"description": "An array of options associated with the field."
}
},
"description": "The metadata object that is associated with the field in the form."
},
"connected_fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"email_service_provider_field_id",
"form_field_id",
"provider_id"
],
"properties": {
"provider_id": {
"enum": [
1,
2,
3,
4,
5,
6,
7
],
"type": "integer",
"example": 1,
"description": "A third-party email service provider.\n\nOption descriptions:\n * `1` - The provider is Mailchimp.\n * `2` - The provider is Campaign Monitor.\n * `3` - The provider is Constant Contact.\n * `4` - The provider is Infusionsoft.\n * `5` - The provider is HubSpot.\n * `6` - The provider is Constant Contact V3.\n * `7` - The provider is Marketo.\n"
},
"form_field_id": {
"type": "number",
"description": "The ID of the field in the form associated with the connected field."
},
"email_service_provider_field_id": {
"type": "string",
"description": "The ID of the provider field."
}
}
},
"description": "The email provider fields associated with the field in the form."
}
}
},
"description": "The hidden fields to show only in the webinar management page. These fields are hidden in the player registration form."
},
"custom_message": {
"type": "string",
"example": "Sign up for our mailing list",
"description": "The message to display on the form."
},
"privacy_policy": {
"type": "string",
"example": "https://mywebsite.com/privacy-policy",
"description": "The URL of the privacy policy related to the form."
}
}
}
embed-settings
{
"type": "object",
"title": "Embed Settings",
"required": [
"airplay",
"ask_ai",
"audio_tracks",
"autopip",
"badges",
"buttons",
"cards",
"chapters",
"chromecast",
"closed_captions",
"color",
"colors",
"email_capture_form",
"end_screen",
"event_schedule",
"has_cards",
"interactive",
"logos",
"outro_type",
"pip",
"play_button",
"playbar",
"quality_selector",
"show_timezone",
"speed",
"title",
"transcript",
"volume"
],
"properties": {
"pip": {
"type": "boolean",
"example": true,
"description": "Whether picture-in-picture is enabled and the button appears in the embeddable player."
},
"uri": {
"type": "string",
"example": "/videos/258684937/presets/12345",
"description": "The URI of the embed preset."
},
"html": {
"type": "string",
"description": "The HTML code for embedding the video on a web page."
},
"cards": {
"type": "array",
"items": {
"type": "object",
"required": [
"display_time",
"headline",
"id",
"image_url",
"teaser",
"timecode",
"url"
],
"properties": {
"id": {
"type": "string",
"description": "The UUID of the card."
},
"url": {
"type": "string",
"description": "The URL of the card."
},
"teaser": {
"type": "string",
"description": "The description of the card."
},
"headline": {
"type": "string",
"description": "The title of the card."
},
"timecode": {
"type": "number",
"description": "The playback timestamp, given in seconds, when the card appears."
},
"image_url": {
"type": "string",
"description": "The URL of the thumbnail for the card."
},
"display_time": {
"type": "number",
"description": "The number of seconds for which the card appears."
}
}
},
"description": "A collection of cards associated with the selected video."
},
"color": {
"type": "string",
"example": "#0a0808",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"logos": {
"type": "object",
"required": [
"custom",
"vimeo"
],
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether the Vimeo logo appears in the embeddable player."
},
"custom": {
"type": "object",
"required": [
"active",
"link",
"sticky",
"url",
"use_link"
],
"properties": {
"url": {
"type": "string",
"example": "http://example.com",
"nullable": true,
"description": "The URL of the selected custom logo."
},
"link": {
"type": "string",
"example": "http://example.com",
"nullable": true,
"description": "The URL that loads upon clicking the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears in the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears even when the player interface is hidden."
},
"use_link": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo should use the URL link."
}
},
"description": "A collection of information relating to custom logos in the embeddable player."
}
},
"description": "A collection of information about the logo in the corner of the embeddable player."
},
"speed": {
"type": "boolean",
"example": true,
"description": "Whether the speed controls appear in the embeddable player."
},
"title": {
"type": "object",
"required": [
"name",
"owner",
"portrait"
],
"properties": {
"name": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video title.\n\nOption descriptions:\n * `hide` - The title is hidden.\n * `show` - The title is shown.\n * `user` - The title can be toggled to `show` or `hide` by the user.\n"
},
"owner": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video owner's information.\n\nOption descriptions:\n * `hide` - The owner's information is hidden.\n * `show` - The owner's information is shown.\n * `user` - The owner's information can be toggled to `show` or `hide` by the user.\n"
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video owner's portrait.\n\nOption descriptions:\n * `hide` - The owner's portrait is hidden\n * `show` - The owner's portrait is shown.\n * `user` - The owner's portrait can be toggled to `show` or `hide` by the user.\n"
}
},
"description": "A collection of information about the embeddable player's title bar."
},
"ask_ai": {
"type": "boolean",
"example": true,
"description": "Whether Ask AI is enabled in the embeddable player."
},
"badges": {
"type": "object",
"required": [
"hdr",
"live",
"staff_pick",
"vod",
"weekend_challenge"
],
"properties": {
"hdr": {
"type": "boolean",
"example": true,
"description": "Whether the video has an HDR-compatible transcode."
},
"vod": {
"type": "boolean",
"example": false,
"description": "Whether the video is a Vimeo On Demand video."
},
"live": {
"type": "object",
"required": [
"archived",
"streaming"
],
"properties": {
"archived": {
"type": "boolean",
"example": false,
"description": "Whether the video was streamed live."
},
"streaming": {
"type": "boolean",
"example": true,
"description": "Whether the video is currently streaming live."
}
}
},
"hdr_10": {
"type": "boolean",
"description": "Whether the video was filmed using HDR10."
},
"staff_pick": {
"type": "object",
"required": [
"best_of_the_month",
"best_of_the_year",
"normal",
"premiere"
],
"properties": {
"normal": {
"type": "boolean",
"example": true,
"description": "Whether the video is a Vimeo Staff Pick."
},
"premiere": {
"type": "boolean",
"example": false,
"description": "Whether the video is a Vimeo Staff Pick Premiere."
},
"best_of_the_year": {
"type": "boolean",
"example": false,
"description": "Whether the video is a Vimeo Staff Pick Best of the Year."
},
"best_of_the_month": {
"type": "boolean",
"example": false,
"description": "Whether the video is a Vimeo Staff Pick Best of the Month."
}
}
},
"hdr_10_plus": {
"type": "boolean",
"description": "Whether the video was filmed using HDR10 Plus."
},
"dolby_vision": {
"type": "boolean",
"description": "Whether the video was filmed using Dolby Vision."
},
"weekend_challenge": {
"type": "boolean",
"example": false,
"description": "Whether the video is a Vimeo Weekend Challenge."
}
},
"description": "A collection of the video's badges."
},
"colors": {
"type": "object",
"required": [
"color_four",
"color_one",
"color_three",
"color_two"
],
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The third player color, which controls the color of text and icons."
}
},
"description": "A collection of information about player colors."
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether the volume controls appear in the embeddable player."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"autopip": {
"type": "boolean",
"example": true,
"description": "Whether automatic picture-in-picture is enabled."
},
"buttons": {
"type": "object",
"required": [
"embed",
"fullscreen",
"hd",
"like",
"reaction",
"scaling",
"share",
"watchlater"
],
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether the `HD` button appears in the embeddable player."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether the `like` button appears in the embeddable player."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether the `embed` button appears in the embeddable player."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether the `share` button appears in the embeddable player."
},
"scaling": {
"type": "boolean",
"example": true,
"description": "Whether the `scaling` button appears in the embeddable player."
},
"reaction": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether the reaction button appears in the embeddable player."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether the `fullscreen` button appears in the embeddable player."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether the `watch later` button appears in the embeddable player."
}
},
"description": "A collection of information about the buttons that appear on the interface of the embeddable player."
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether the playbar appears in the embeddable player."
},
"chapters": {
"type": "boolean",
"example": true,
"description": "Whether chapters are enabled in the embeddable player."
},
"has_cards": {
"type": "boolean",
"example": true,
"description": "Whether the video has cards."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"end_screen": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"empty",
"loop",
"share",
"thumbnail"
],
"type": "string",
"example": "empty",
"description": "How the embeddable player handles the end screen.\n\nOption descriptions:\n * `empty` - The end screen is empty.\n * `loop` - The end screen loops the video playback.\n * `share` - The end screen includes sharing options.\n * `thumbnail` - The end screen includes the thumbnail of the video.\n"
}
},
"description": "A collection of information about the embeddable player's end screen."
},
"outro_type": {
"enum": [
"beginning",
"custom",
"email",
"image",
"link",
"loop",
"nothing",
"share",
"text",
"threevideos",
"videos"
],
"type": "string",
"example": "link",
"description": "The type of the video outro.\n\nOption descriptions:\n * `beginning` - The outro is a thumbnail.\n * `custom` - The outro is custom.\n * `email` - The outro is an email form.\n * `image` - The outro is an image.\n * `link` - The outro is a link.\n * `loop` - The outro is a loop.\n * `nothing` - There is no outro.\n * `share` - The outro is a share button.\n * `text` - The outro is text.\n * `threevideos` - The outro is three video suggestions.\n * `videos` - The outro is video suggestions.\n"
},
"transcript": {
"type": "boolean",
"example": true,
"description": "Whether the transcript controls appear in the embeddable player."
},
"interactive": {
"type": "boolean",
"example": true,
"description": "Whether the video is an interactive video."
},
"play_button": {
"type": "object",
"required": [
"position"
],
"properties": {
"position": {
"enum": [
"auto",
"bottom",
"center"
],
"type": "string",
"example": "auto",
"description": "The position of the play button within the embeddable player.\n\nOption descriptions:\n * `auto` - Use Vimeo's default positioning for the play button.\n * `bottom` - The play button is positioned at the bottom of the player, except when in tiny mode.\n * `center` - The play button is positioned in the center of the player.\n"
}
},
"description": "A representation of the play button's settings."
},
"audio_tracks": {
"type": "boolean",
"example": true,
"description": "Whether multiple audio tracks can appear in the embeddable player."
},
"show_timezone": {
"type": "boolean",
"example": false,
"description": "Whether the embedded player should display the schedule timezone."
},
"event_schedule": {
"type": "boolean",
"example": true,
"description": "Whether the embedded player should display the event schedule."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"quality_selector": {
"type": "boolean",
"example": true,
"description": "Whether the quality selector appears in the embeddable player."
},
"email_capture_form": {
"$ref": "#/components/schemas/email-capture-form"
}
},
"x-konfig-properties": {
"email_capture_form": {
"description": "The email capture form settings associated with the video."
}
}
}
endpoint
{
"type": "object",
"title": "Endpoint",
"required": [
"methods",
"path"
],
"properties": {
"path": {
"type": "string",
"example": "/me",
"description": "The path section of the URL, which, when appended to the API host `https:///api.vimeo.com`, builds a full API endpoint."
},
"methods": {
"type": "array",
"items": {
"type": "string"
},
"description": "All HTTP methods permitted on this endpoint."
}
}
}
error
{
"type": "object",
"title": "Error",
"required": [
"developer_message",
"error",
"error_code",
"link"
],
"properties": {
"link": {
"type": "string",
"description": "A link to more information about the error."
},
"error": {
"type": "string",
"example": "Something strange occurred. Please try again.",
"description": "The error message that general users receive."
},
"error_code": {
"type": "number",
"example": 5000,
"description": "The error code."
},
"developer_message": {
"type": "string",
"example": "The specified resource does not exist.",
"description": "The error message that technical users receive."
}
}
}
fragments
{
"type": "object",
"title": "Fragments",
"required": [
"created_on",
"metadata",
"modified_on",
"timecode",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/!clip_id/fragments",
"description": "The URI of the video fragment."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"clip"
],
"properties": {
"clip": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/710320868",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to this channel."
}
},
"description": "A collection of information that is connected to this resource."
}
},
"description": "Metadata about the fragments."
},
"timecode": {
"type": "number",
"example": 11145,
"description": "The time in milliseconds of the fragment's _inpoint_, or the time from the start of the video that marks the beginning of the fragment."
},
"created_on": {
"type": "string",
"example": "2022-05-23T15:24:31+00:00",
"description": "The time in ISO 8601 format when the fragment was created."
},
"modified_on": {
"type": "string",
"example": "2022-05-23T15:24:31+00:00",
"description": "The time in ISO 8601 format when the fragment was last updated."
}
}
}
group
{
"type": "object",
"title": "Group",
"required": [
"created_time",
"description",
"link",
"metadata",
"modified_time",
"name",
"pictures",
"privacy",
"resource_key",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/groups/1108",
"description": "The canonical relative URI of the group."
},
"link": {
"type": "string",
"example": "https://vimeo.com/groups/weekendchallenge",
"description": "The link to the group."
},
"name": {
"type": "string",
"example": "Vimeo Weekend Challenge",
"description": "The group's display name."
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The owner of the group."
},
"privacy": {
"type": "object",
"required": [
"comment",
"invite",
"join",
"videos",
"view"
],
"properties": {
"join": {
"enum": [
"anybody",
"members"
],
"type": "string",
"example": "anybody",
"description": "Who can join the group.\n\nOption descriptions:\n * `anybody` - Anyone can join the group.\n * `members` - Only people with a Vimeo account can join the group.\n"
},
"view": {
"enum": [
"anybody",
"members"
],
"type": "string",
"example": "anybody",
"description": "Who can access the group.\n\nOption descriptions:\n * `anybody` - Anyone can access the group. This privacy setting appears as `Public` on the Vimeo front end.\n * `members` - Only group members can access the group.\n"
},
"invite": {
"enum": [
"all",
"members"
],
"type": "string",
"example": "all",
"description": "Who can invite new members to the group.\n\nOption descriptions:\n * `all` - Anyone can invite new members to the group.\n * `members` - Only group members can invite new members to the group.\n"
},
"videos": {
"enum": [
"all",
"members"
],
"type": "string",
"example": "all",
"description": "Who can add videos to the group.\n\nOption descriptions:\n * `all` - Anyone can add videos to the group.\n * `members` - Only group members can add videos to the group.\n"
},
"comment": {
"enum": [
"all",
"members"
],
"type": "string",
"example": "all",
"description": "Who can comment on the group.\n\nOption descriptions:\n * `all` - Anyone can comment on the group.\n * `members` - Only group members can comment on the group.\n"
}
},
"description": "The group's privacy settings."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"users",
"videos"
],
"properties": {
"users": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/groups/1108/users",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 25798,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the members or moderators of the group."
},
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/groups/1108/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 7252,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos contained within the group."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"required": [
"join"
],
"properties": {
"join": {
"type": "object",
"required": [
"added",
"added_time",
"title",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/groups/1108",
"description": "The URI for following the group. PUT to this URI to follow the group, or DELETE to this URI to unfollow the group. This data requires a bearer token with the `private` scope."
},
"type": {
"enum": [
"member",
"moderator"
],
"type": "string",
"example": "member",
"nullable": true,
"description": "Whether the user is a moderator or subscriber. This data requires a bearer token with the `private` scope.\n\nOption descriptions:\n * `member` - The user is a member.\n * `moderator` - The user is a moderator.\n"
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the user has followed the group. This data requires a bearer token with the `private` scope."
},
"title": {
"type": "string",
"example": "Vimeo Staff",
"nullable": true,
"description": "The user's title. If this field isn't applicable, it takes the null value. This data requires a bearer token with the `private` scope."
},
"added_time": {
"type": "string",
"nullable": true,
"description": "The time in ISO 8601 format when the user joined the group. This data requires a bearer token with the `private` scope."
}
},
"description": "An action indicating that someone has joined the group. This data requires a bearer token with the `private` scope."
}
},
"description": "User actions that have involved the group. This data requires a bearer token with the `private` scope."
}
},
"description": "Metadata about the group."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"description": {
"type": "string",
"example": "Want to participate in our weekly challenges? Join the group to receive messages and new challenges!",
"nullable": true,
"description": "The group's description."
},
"created_time": {
"type": "string",
"example": "2008-07-05T14:52:43+00:00",
"description": "The time in ISO 8601 format when the group was created."
},
"resource_key": {
"type": "string",
"example": "dc724af18fbdd4e59189f5fe768a5f8311527050",
"description": "The resource key of the group."
},
"modified_time": {
"type": "string",
"example": "2018-09-16T15:41:45+00:00",
"description": "The time in ISO 8601 format when the group was last modified."
}
},
"x-konfig-properties": {
"pictures": {
"description": "The active picture for the group."
}
}
}
hls-dash-video-file
{
"type": "object",
"title": "HLS/DASH Video File",
"required": [
"link",
"link_expiration_time"
],
"properties": {
"log": {
"type": "string",
"example": "https:/api.vimeo.com/videos/258684937/log/12337123/76af42bfd",
"nullable": true,
"description": "The URL for logging events."
},
"link": {
"type": "string",
"example": "https://player.vimeo.com/play/965853365?s=258684937_1537",
"nullable": true,
"description": "The direct link to the video file."
},
"link_expiration_time": {
"type": "string",
"example": "2017-05-16T17:21:51+00:00",
"description": "The time in ISO 8601 format when the link to the video file expires."
}
}
}
language
{
"type": "object",
"title": "Language",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"example": "en-US",
"description": "The standard ISO 639-1 code for the language."
},
"name": {
"type": "string",
"example": "English (United States)",
"description": "The name of the language."
}
}
}
legacy-error
{
"type": "object",
"title": "Legacy Error",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"example": "Something strange occurred. Please try again.",
"description": "The error message."
}
}
}
live-event
{
"type": "object",
"title": "Live Event",
"required": [
"album",
"allow_share_link",
"allowed_privacies",
"auto_cc_enabled",
"auto_cc_keywords",
"auto_cc_language",
"auto_cc_remaining",
"automatically_title_stream",
"chat_enabled",
"completed_on",
"content_rating",
"created_time",
"dvr",
"email_quota",
"embed",
"from_showcase",
"head_clip",
"interaction_tools_settings",
"latency",
"lead_uuid",
"link",
"live_clips",
"live_destinations",
"low_latency",
"metadata",
"next_occurrence_time",
"parent_folder",
"pictures",
"playlist_sort",
"preferred_stream_method",
"rtmp_link",
"rtmp_preview",
"rtmps_link",
"schedule",
"scheduled_playback",
"status",
"stream_description",
"stream_key",
"stream_mode",
"stream_password",
"stream_privacy",
"stream_title",
"streamable_clip",
"time_zone",
"title",
"unlimited_auto_cc",
"unlimited_duration",
"uri",
"user",
"view_link",
"webinar",
"whitelisted_domains"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"uri": {
"type": "string",
"example": "/live_events/12345",
"description": "The event's canonical relative URI."
},
"link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo."
},
"user": {
"$ref": "#/components/schemas/user"
},
"album": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated showcase."
},
"embed": {
"type": "object",
"required": [
"airplay",
"autoplay",
"available_player_logos",
"byline",
"chat_embed_source",
"chromecast",
"closed_captions",
"color",
"colors",
"embed_chat",
"embed_properties",
"event_schedule",
"fullscreen_button",
"hide_live_label",
"hide_viewer_count",
"html",
"like_button",
"logos",
"loop",
"pip",
"play_button_position",
"playbar",
"playlist",
"portrait",
"responsive_html",
"schedule",
"show_latest_archived_clip",
"show_timezone",
"title",
"use_color",
"volume"
],
"properties": {
"pip": {
"type": "boolean",
"example": true,
"description": "Whether picture-in-picture is enabled and the button appears in the embeddable player."
},
"html": {
"type": "string",
"nullable": true,
"description": "The fixed HTML code to embed the event's playlist on a website."
},
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should loop back to the first video once content is exhausted."
},
"color": {
"type": "string",
"example": "#0a0808",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"logos": {
"type": "object",
"required": [
"custom",
"vimeo"
],
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether the Vimeo logo appears in the embeddable player for the video."
},
"custom": {
"type": "object",
"required": [
"active",
"link",
"sticky",
"url",
"use_link"
],
"properties": {
"url": {
"type": "string",
"example": "http://example.com",
"description": "The URL source of the custom player logo."
},
"link": {
"type": "string",
"example": "http://example.com",
"description": "The URL that loads upon clicking the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears in the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears even when the player interface is hidden."
},
"use_link": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo should use the URL link."
}
},
"description": "A collection of information relating to custom logos in the embeddable player."
}
},
"description": "A collection of information about the logo in the corner of the embeddable player."
},
"title": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the video title."
},
"byline": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's name."
},
"colors": {
"type": "object",
"required": [
"color_four",
"color_one",
"color_three",
"color_two"
],
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The third player color, which controls the color of text and icons."
}
},
"description": "A collection of information about player colors."
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the volume controls."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the playbar."
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should autoplay the RLE content."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether the playlist component appears in the embeddable player for this RLE."
},
"portrait": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's portrait."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether the schedule component appears in the embeddable player for this RLE."
},
"use_color": {
"type": "string",
"example": "true",
"description": "Whether the embedded RLE player should use a custom color or the default Vimeo blue."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"embed_chat": {
"type": "string",
"nullable": true,
"description": "The embed code for RLE chat."
},
"like_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the `like` button."
},
"show_timezone": {
"type": "boolean",
"example": false,
"description": "Whether the embedded RLE player should display the schedule timezone."
},
"event_schedule": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the event schedule."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"hide_live_label": {
"type": "boolean",
"example": false,
"description": "Whether the Live label should be visible over the player."
},
"responsive_html": {
"type": "string",
"nullable": true,
"description": "The responsive HTML code to embed the event's playlist on a website."
},
"embed_properties": {
"type": "object",
"nullable": true,
"required": [
"height",
"source_url",
"width"
],
"properties": {
"width": {
"type": "string",
"description": "The width used to generate the fixed HTML embed code."
},
"height": {
"type": "string",
"description": "The height used to generate the fixed HTML embed code."
},
"source_url": {
"type": "string",
"description": "The source URL used to generate the fixed HTML embed code."
}
},
"description": "The height, width, and source URL properties used to generate the fixed HTML embed code."
},
"chat_embed_source": {
"type": "string",
"nullable": true,
"description": "The chat's iFrame source URL."
},
"fullscreen_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the fullscreen controls."
},
"hide_viewer_count": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should hide the viewer counter."
},
"play_button_position": {
"enum": [
0,
1,
2
],
"type": "integer",
"description": "The position of the player's play button.\n\nOption descriptions:\n * `0` - The play button has the default position.\n * `1` - The play button appears at the bottom of the interface.\n * `2` - The play button appears in the center of the interface.\n"
},
"available_player_logos": {
"type": "array",
"items": {
"type": "string"
},
"description": "The list of user-uploaded logos for configuration of the embed player."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the latest video placeholder."
}
},
"description": "The event's embed data."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. This field is also optionally used as the base title for videos created by streaming to the event."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"nullable": true,
"description": "The status of the event.\n\nOption descriptions:\n * `ended` - The user ended the event.\n * `started` - The user started the event.\n"
},
"latency": {
"enum": [
"fail-safe",
"low",
"standard"
],
"type": "string",
"example": "standard",
"description": "The type of latency.\n\nOption descriptions:\n * `fail-safe` - The latency is in the failsafe range, with a delay of 60-75 seconds.\n * `low` - The latency is low, with a delay of 5-7 seconds.\n * `standard` - The latency is standard, with a delay of 15-20 seconds.\n"
},
"webinar": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated webinar."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"live_video",
"pictures",
"pre_live_video",
"team_member",
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to the event."
},
"pictures": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/pictures",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's thumbnails."
},
"live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"streaming"
],
"type": "string",
"example": "streaming",
"description": "The status of the live video's RTMP link.\n\nOption descriptions:\n * `streaming` - The stream is open and receiving content.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's live video, where applicable."
},
"team_member": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456789/team_users/123456",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the team member who owns the event."
},
"pre_live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"pending",
"ready",
"streaming",
"unavailable"
],
"type": "string",
"example": "pending",
"description": "The status of the pre-live video's RTMP link.\n\nOption descriptions:\n * `pending` - Vimeo is working on setting up the connection.\n * `ready` - Resources have been provisioned for the event.\n * `streaming` - Live video is currently streaming to the RTMP link.\n * `unavailable` - The connection is ready, but streaming to the RTMP link has not yet begun.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's pre-live video, where applicable. A pre-live video is either activated or in the process of being activated."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"required": [
"activate",
"delete",
"edit"
],
"properties": {
"edit": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit an item."
},
"delete": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to delete an item."
},
"activate": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to activate the event."
}
},
"description": "A list of resource URIs related to the event."
}
},
"description": "Metadata about the event."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"schedule": {
"$ref": "#/components/schemas/live-event-schedule"
},
"head_clip": {
"type": "object",
"nullable": true,
"description": "The first video to be played in the playlist."
},
"lead_uuid": {
"type": "string",
"description": "The unique ID for the registered viewer."
},
"rtmp_link": {
"type": "string",
"example": "rtmp://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMP link. Send your live content to this link to create a live video on the event."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps included in auto-generated video titles."
},
"view_link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo with or without an unlisted hash."
},
"live_clips": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of videos belonging to the event, including their video IDs and dates streamed."
},
"rtmps_link": {
"type": "string",
"example": "rtmps://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMPS link. Send your live content to this link to create a live video on the event."
},
"stream_key": {
"type": "string",
"example": "ab9c8def-7a65-4321-b098-c7dd65e43f21",
"nullable": true,
"description": "The stream key used in conjunction with the RTMP and RTMPS links."
},
"email_quota": {
"type": "object",
"required": [
"capping",
"total"
],
"properties": {
"total": {
"type": "number",
"example": 300,
"description": "The current number of entity emails that the user has sent."
},
"capping": {
"type": "number",
"example": 400,
"description": "The maximum number of entity emails that the user can send."
}
},
"description": "Information about the event owner's email quota."
},
"low_latency": {
"type": "boolean",
"example": false,
"description": "Whether the low-latency feature is enabled."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display live chat on the event page on Vimeo."
},
"completed_on": {
"type": "string",
"example": "2021-11-11T11:24:56+00:00",
"description": "The time in ISO 8601 format when the event was completed."
},
"created_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the event was created."
},
"from_webinar": {
"type": "boolean",
"description": "Whether the event was created from a webinar."
},
"rtmp_preview": {
"type": "boolean",
"example": true,
"description": "Whether to preview the RTMP stream before the event goes live."
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video streamed to the event. This field applies only when **automatically_title_stream** is `false`."
},
"from_showcase": {
"type": "boolean",
"description": "Whether the event was created from a showcase."
},
"parent_folder": {
"allOf": [
{
"$ref": "#/components/schemas/project"
}
],
"nullable": true,
"description": "Information about the folder that contains the event."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos inside the event appear in the playlist.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the event, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the event, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the event.\n * `comments` - The videos appear according to their number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order, with the newest first.\n * `oldest` - The videos appear in chronological order, with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"content_rating": {
"enum": [
"advertisement",
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "advertisement"
},
"description": "The event's granular content ratings.\n\nOption descriptions:\n * `advertisement` - The event contains advertisements.\n * `drugs` - The event contains drug or alcohol use.\n * `language` - The event contains profanity or sexually suggestive content.\n * `nudity` - The event contains nudity.\n * `safe` - The event is safe for all audiences.\n * `unrated` - The event hasn't been rated.\n * `violence` - The event contains violence.\n"
},
"stream_privacy": {
"type": "object",
"required": [
"embed",
"unlisted_hash",
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The general privacy setting for generated videos and the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The videos don't appear on Vimeo, but they can be embedded elsewhere.\n * `nobody` - Only the event owner can access the videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the videos.\n * `unlisted` - Only those with the private link can access the videos.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The event's embed permission setting.\n\nOption descriptions:\n * `private` - The event can't be embedded on any domain.\n * `public` - The event can be embedded on any domain.\n * `whitelist` - The event can be embedded on whitelisted domains only.\n"
},
"unlisted_hash": {
"type": "string",
"example": "1a2b3c4d5e",
"nullable": true,
"description": "The hash for unlisted events."
}
},
"description": "The initial privacy settings of videos generated by streaming to the event as well as the embed privacy of the entire collection."
},
"auto_cc_enabled": {
"type": "boolean",
"nullable": true,
"description": "Whether the automated closed captions feature is enabled."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"nullable": true,
"description": "The password that anyone can use to access the videos generated by streaming to the event."
},
"streamable_clip": {
"type": "object",
"nullable": true,
"description": "The event's video. An event always has a video, which is either in a pre-live state (ready to be streamed to) or in a live state (which is currently being streamed to)."
},
"allow_share_link": {
"type": "boolean",
"example": true,
"description": "Whether the share link for the videos generated by streaming to the event is usable."
},
"auto_cc_keywords": {
"type": "string",
"nullable": true,
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"nullable": true,
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"allowed_privacies": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of privacy settings supported for this event and the requesting user."
},
"auto_cc_remaining": {
"type": "number",
"nullable": true,
"description": "The amount of time remaining to the user to access the automated closed captions feature."
},
"live_destinations": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "_This field is deprecated in favor of the following method:_ [Get all the destinations of a one-time live event](https://developer.vimeo.com/api/reference/live#get_one_time_event_destinations)."
},
"unlimited_auto_cc": {
"type": "boolean",
"nullable": true,
"description": "Whether to ignore the time limit of the automated closed captions feature."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"nullable": true,
"description": "The description of the next video streamed to the event."
},
"unlimited_duration": {
"type": "boolean",
"example": true,
"description": "Whether 24/7 streaming is enabled for the event."
},
"whitelisted_domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"allow_hd",
"domain",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/privacy/domains/example.com",
"description": "The URI of the domain."
},
"domain": {
"type": "string",
"example": "example.com",
"description": "The domain name."
},
"allow_hd": {
"type": "boolean",
"example": true,
"description": "Whether to permit HD embeds on this domain."
}
}
},
"nullable": true,
"description": "The domains on a video's whitelist."
},
"next_occurrence_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The date in ISO 8601 format on which the next occurrence of the event is expected to be live."
},
"preferred_stream_method": {
"enum": [
"browser",
"encoder"
],
"type": "string",
"example": "encoder",
"description": "The preferred streaming method.\n\nOption descriptions:\n * `browser` - Stream in the browser.\n * `encoder` - Stream by the encoder.\n"
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "When the value of this field is `true`, the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "array",
"items": {
"type": "object",
"required": [
"is_anonymous_questions_disabled",
"is_qna_moderated"
],
"properties": {
"is_qna_moderated": {
"type": "boolean",
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
}
},
"nullable": true,
"description": "The settings for the interaction tools."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the event."
},
"pictures": {
"description": "The active thumbnail image of the event."
},
"schedule": {
"description": "The description of the time or times that the event is expected to be live."
}
}
}
live-event-automated-closed-captions
{
"type": "object",
"title": "Live Event Automated Closed Captions",
"required": [
"auto_cc_can_be_enabled",
"auto_cc_enabled",
"auto_cc_is_unlimited",
"auto_cc_keywords",
"auto_cc_language",
"auto_cc_remaining",
"event_id"
],
"properties": {
"event_id": {
"type": "number",
"example": 1111,
"description": "The ID of the event."
},
"auto_cc_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the option for automated closed captions is enabled."
},
"auto_cc_keywords": {
"type": "string",
"example": "sun,water,wind",
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"type": "string",
"example": "en",
"nullable": true,
"description": "The language of the automated closed captions."
},
"auto_cc_remaining": {
"type": "number",
"example": 300,
"description": "The number of minutes remaining for automated closed captions in the user's current period."
},
"auto_cc_is_unlimited": {
"type": "boolean",
"example": false,
"description": "Whether automated closed captions are unlimited for the user."
},
"auto_cc_can_be_enabled": {
"type": "boolean",
"example": false,
"description": "Whether automated closed captions can be enabled."
}
}
}
live-event-destination
{
"type": "object",
"title": "Live Event Destination",
"required": [
"display_name",
"id",
"is_enabled",
"live_clip_id",
"privacy",
"provider_broadcast_id",
"provider_destination_id",
"provider_user_id",
"provider_video_id",
"scheduled_at",
"service_name",
"state",
"state_message",
"stream_key",
"stream_url",
"type",
"user_id"
],
"properties": {
"id": {
"type": "number",
"example": 1234,
"description": "The ID of the destination."
},
"type": {
"enum": [
"channel",
"custom",
"organization",
"page",
"profile"
],
"type": "string",
"example": "channel",
"description": "The type of the simulcast destination.\n\nOption descriptions:\n * `channel` - The destination is a YouTube channel.\n * `custom` - The destination is custom.\n * `organization` - The destination is a LinkedIn organization.\n * `page` - The destination is a Facebook page.\n * `profile` - The destination is a Facebook or LinkedIn profile.\n"
},
"state": {
"enum": [
0,
1
],
"type": "integer",
"description": "The status of the destination.\n\nOption descriptions:\n * `0` - The status is OK.\n * `1` - An error occurred. Check the `state_message` field for details.\n"
},
"privacy": {
"enum": [
"CONNECTIONS",
"PUBLIC",
"all_friends",
"everyone",
"private",
"public",
"self",
"unlisted"
],
"type": "string",
"example": "public",
"nullable": true,
"description": "The privacy setting of the destination.\n\nOption descriptions:\n * `CONNECTIONS` - The privacy setting is `CONNECTIONS` for LinkedIn.\n * `PUBLIC` - The privacy setting is `PUBLIC` for LinkedIn.\n * `all_friends` - The privacy setting is `all_friends` for Facebook.\n * `everyone` - The privacy setting is `everyone` for Facebook.\n * `private` - The privacy setting is `private` for YouTube.\n * `public` - The privacy setting is `public` for YouTube.\n * `self` - The privacy setting is `self` for Facebook.\n * `unlisted` - The privacy setting is `unlisted` for YouTube.\n"
},
"user_id": {
"type": "number",
"example": 123456,
"description": "The ID of the destination's owner."
},
"is_enabled": {
"type": "boolean",
"example": true,
"description": "Whether the destination is enabled."
},
"stream_key": {
"type": "string",
"example": "b624fa1e-23d8-4d27-90f9-fe7d0ad700ed",
"nullable": true,
"description": "The stream key for the simulcast destination."
},
"stream_url": {
"type": "string",
"example": "rtmp://cooldomain.com/live",
"nullable": true,
"description": "The RTMP URL to stream to."
},
"display_name": {
"type": "string",
"example": "Test page",
"description": "The name of the destination target, whether a page, profile name, or the like."
},
"live_clip_id": {
"type": "number",
"example": 123456,
"description": "The ID of the live video."
},
"scheduled_at": {
"type": "number",
"example": 1625754461,
"nullable": true,
"description": "The time in Unix timestamp format when live streaming is scheduled to start."
},
"service_name": {
"enum": [
"custom_rtmp",
"facebook",
"linkedin",
"youtube"
],
"type": "string",
"example": "facebook",
"description": "The name of the destination service.\n\nOption descriptions:\n * `custom_rtmp` - The destination service is custom RTMP.\n * `facebook` - The destination service is Facebook Live.\n * `linkedin` - The destination service is LinkedIn Live.\n * `youtube` - The destination service is YouTube Live.\n"
},
"state_message": {
"type": "string",
"example": "\"Couldn't connect to rtmp://1.2.3.4/live\"",
"nullable": true,
"description": "The message that describes the state of the destination."
},
"provider_user_id": {
"type": "string",
"example": "a6378de4995a",
"nullable": true,
"description": "The user ID of the destination service."
},
"provider_video_id": {
"type": "string",
"example": "6817807391346708000",
"nullable": true,
"description": "The ID of the scheduled live video."
},
"provider_broadcast_id": {
"type": "string",
"example": "9fe254b7d55e7542da9fbd46a5deb947",
"nullable": true,
"description": "The destination ID of the destination service."
},
"provider_destination_id": {
"type": "string",
"example": "fm4m34gm5oirbkjfkfnkkdhgfi45v3df34oz",
"nullable": true,
"description": "The broadcast ID of the destination service."
}
}
}
live-event-recurring
{
"type": "object",
"title": "Live Event Recurring",
"required": [
"album",
"allow_share_link",
"allowed_privacies",
"auto_cc_enabled",
"auto_cc_keywords",
"auto_cc_language",
"auto_cc_remaining",
"automatically_title_stream",
"chat_enabled",
"completed_on",
"content_rating",
"created_time",
"dvr",
"email_quota",
"embed",
"from_showcase",
"head_clip",
"interaction_tools_settings",
"latency",
"lead_uuid",
"link",
"live_clips",
"live_destinations",
"low_latency",
"metadata",
"next_occurrence_time",
"parent_folder",
"pictures",
"playlist_sort",
"preferred_stream_method",
"rtmp_link",
"rtmp_preview",
"rtmps_link",
"schedule",
"scheduled_playback",
"status",
"stream_description",
"stream_key",
"stream_mode",
"stream_password",
"stream_privacy",
"stream_title",
"streamable_clip",
"time_zone",
"title",
"unlimited_auto_cc",
"unlimited_duration",
"uri",
"user",
"view_link",
"webinar",
"whitelisted_domains"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"uri": {
"type": "string",
"example": "/live_events/12345",
"description": "The event's canonical relative URI."
},
"link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo."
},
"user": {
"$ref": "#/components/schemas/user"
},
"album": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated showcase."
},
"embed": {
"type": "object",
"required": [
"airplay",
"autoplay",
"available_player_logos",
"byline",
"chat_embed_source",
"chromecast",
"closed_captions",
"color",
"colors",
"embed_chat",
"embed_properties",
"event_schedule",
"fullscreen_button",
"hide_live_label",
"hide_viewer_count",
"html",
"like_button",
"logos",
"loop",
"pip",
"play_button_position",
"playbar",
"playlist",
"portrait",
"responsive_html",
"schedule",
"show_latest_archived_clip",
"show_timezone",
"title",
"use_color",
"volume"
],
"properties": {
"pip": {
"type": "boolean",
"example": true,
"description": "Whether picture-in-picture is enabled and the button appears in the embeddable player."
},
"html": {
"type": "string",
"nullable": true,
"description": "The fixed HTML code to embed the event's playlist on a website."
},
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should loop back to the first video once content is exhausted."
},
"color": {
"type": "string",
"example": "#0a0808",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"logos": {
"type": "object",
"required": [
"custom",
"vimeo"
],
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether the Vimeo logo appears in the embeddable player for the video."
},
"custom": {
"type": "object",
"required": [
"active",
"link",
"sticky",
"url",
"use_link"
],
"properties": {
"url": {
"type": "string",
"example": "http://example.com",
"description": "The URL source of the custom player logo."
},
"link": {
"type": "string",
"example": "http://example.com",
"description": "The URL that loads upon clicking the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears in the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears even when the player interface is hidden."
},
"use_link": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo should use the URL link."
}
},
"description": "A collection of information relating to custom logos in the embeddable player."
}
},
"description": "A collection of information about the logo in the corner of the embeddable player."
},
"title": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the video title."
},
"byline": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's name."
},
"colors": {
"type": "object",
"required": [
"color_four",
"color_one",
"color_three",
"color_two"
],
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The third player color, which controls the color of text and icons."
}
},
"description": "A collection of information about player colors."
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the volume controls."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the playbar."
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should autoplay the RLE content."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether the playlist component appears in the embeddable player for this RLE."
},
"portrait": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's portrait."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether the schedule component appears in the embeddable player for this RLE."
},
"use_color": {
"type": "string",
"example": "true",
"description": "Whether the embedded RLE player should use a custom color or the default Vimeo blue."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"embed_chat": {
"type": "string",
"nullable": true,
"description": "The embed code for RLE chat."
},
"like_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the `like` button."
},
"show_timezone": {
"type": "boolean",
"example": false,
"description": "Whether the embedded RLE player should display the schedule timezone."
},
"event_schedule": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the event schedule."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"hide_live_label": {
"type": "boolean",
"example": false,
"description": "Whether the Live label should be visible over the player."
},
"responsive_html": {
"type": "string",
"nullable": true,
"description": "The responsive HTML code to embed the event's playlist on a website."
},
"embed_properties": {
"type": "object",
"nullable": true,
"required": [
"height",
"source_url",
"width"
],
"properties": {
"width": {
"type": "string",
"description": "The width used to generate the fixed HTML embed code."
},
"height": {
"type": "string",
"description": "The height used to generate the fixed HTML embed code."
},
"source_url": {
"type": "string",
"description": "The source URL used to generate the fixed HTML embed code."
}
},
"description": "The height, width, and source URL properties used to generate the fixed HTML embed code."
},
"chat_embed_source": {
"type": "string",
"nullable": true,
"description": "The chat's iFrame source URL."
},
"fullscreen_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the fullscreen controls."
},
"hide_viewer_count": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should hide the viewer counter."
},
"play_button_position": {
"enum": [
0,
1,
2
],
"type": "integer",
"description": "The position of the player's play button.\n\nOption descriptions:\n * `0` - The play button has the default position.\n * `1` - The play button appears at the bottom of the interface.\n * `2` - The play button appears in the center of the interface.\n"
},
"available_player_logos": {
"type": "array",
"items": {
"type": "string"
},
"description": "The list of user-uploaded logos for configuration of the embed player."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the latest video placeholder."
}
},
"description": "The event's embed data."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. This field is also optionally used as the base title for videos created by streaming to the event."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"nullable": true,
"description": "The status of the event.\n\nOption descriptions:\n * `ended` - The user ended the event.\n * `started` - The user started the event.\n"
},
"latency": {
"enum": [
"fail-safe",
"low",
"standard"
],
"type": "string",
"example": "standard",
"description": "The type of latency.\n\nOption descriptions:\n * `fail-safe` - The latency is in the failsafe range, with a delay of 60-75 seconds.\n * `low` - The latency is low, with a delay of 5-7 seconds.\n * `standard` - The latency is standard, with a delay of 15-20 seconds.\n"
},
"webinar": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated webinar."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"live_video",
"pictures",
"pre_live_video",
"team_member",
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to the event."
},
"pictures": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/pictures",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's thumbnails."
},
"live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"streaming"
],
"type": "string",
"example": "streaming",
"description": "The status of the live video's RTMP link.\n\nOption descriptions:\n * `streaming` - The stream is open and receiving content.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's live video, where applicable."
},
"team_member": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456789/team_users/123456",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the team member who owns the event."
},
"pre_live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"pending",
"ready",
"streaming",
"unavailable"
],
"type": "string",
"example": "pending",
"description": "The status of the pre-live video's RTMP link.\n\nOption descriptions:\n * `pending` - Vimeo is working on setting up the connection.\n * `ready` - Resources have been provisioned for the event.\n * `streaming` - Live video is currently streaming to the RTMP link.\n * `unavailable` - The connection is ready, but streaming to the RTMP link has not yet begun.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's pre-live video, where applicable. A pre-live video is either activated or in the process of being activated."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"required": [
"activate",
"delete",
"edit"
],
"properties": {
"edit": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit an item."
},
"delete": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to delete an item."
},
"activate": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to activate the event."
}
},
"description": "A list of resource URIs related to the event."
}
},
"description": "Metadata about the event."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"schedule": {
"$ref": "#/components/schemas/live-event-schedule"
},
"head_clip": {
"type": "object",
"nullable": true,
"description": "The first video to be played in the playlist."
},
"lead_uuid": {
"type": "string",
"description": "The unique ID for the registered viewer."
},
"rtmp_link": {
"type": "string",
"example": "rtmp://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMP link. Send your live content to this link to create a live video on the event."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps included in auto-generated video titles."
},
"view_link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo with or without an unlisted hash."
},
"live_clips": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of videos belonging to the event, including their video IDs and dates streamed."
},
"rtmps_link": {
"type": "string",
"example": "rtmps://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMPS link. Send your live content to this link to create a live video on the event."
},
"stream_key": {
"type": "string",
"example": "ab9c8def-7a65-4321-b098-c7dd65e43f21",
"nullable": true,
"description": "The stream key used in conjunction with the RTMP and RTMPS links."
},
"email_quota": {
"type": "object",
"required": [
"capping",
"total"
],
"properties": {
"total": {
"type": "number",
"example": 300,
"description": "The current number of entity emails that the user has sent."
},
"capping": {
"type": "number",
"example": 400,
"description": "The maximum number of entity emails that the user can send."
}
},
"description": "Information about the event owner's email quota."
},
"low_latency": {
"type": "boolean",
"example": false,
"description": "Whether the low-latency feature is enabled."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display live chat on the event page on Vimeo."
},
"completed_on": {
"type": "string",
"example": "2021-11-11T11:24:56+00:00",
"description": "The time in ISO 8601 format when the event was completed."
},
"created_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the event was created."
},
"from_webinar": {
"type": "boolean",
"description": "Whether the event was created from a webinar."
},
"rtmp_preview": {
"type": "boolean",
"example": true,
"description": "Whether to preview the RTMP stream before the event goes live."
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video streamed to the event. This field applies only when **automatically_title_stream** is `false`."
},
"from_showcase": {
"type": "boolean",
"description": "Whether the event was created from a showcase."
},
"parent_folder": {
"allOf": [
{
"$ref": "#/components/schemas/project"
}
],
"nullable": true,
"description": "Information about the folder that contains the event."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos inside the event appear in the playlist.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the event, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the event, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the event.\n * `comments` - The videos appear according to their number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order, with the newest first.\n * `oldest` - The videos appear in chronological order, with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"content_rating": {
"enum": [
"advertisement",
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "advertisement"
},
"description": "The event's granular content ratings.\n\nOption descriptions:\n * `advertisement` - The event contains advertisements.\n * `drugs` - The event contains drug or alcohol use.\n * `language` - The event contains profanity or sexually suggestive content.\n * `nudity` - The event contains nudity.\n * `safe` - The event is safe for all audiences.\n * `unrated` - The event hasn't been rated.\n * `violence` - The event contains violence.\n"
},
"stream_privacy": {
"type": "object",
"required": [
"embed",
"unlisted_hash",
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The general privacy setting for generated videos and the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The videos don't appear on Vimeo, but they can be embedded elsewhere.\n * `nobody` - Only the event owner can access the videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the videos.\n * `unlisted` - Only those with the private link can access the videos.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The event's embed permission setting.\n\nOption descriptions:\n * `private` - The event can't be embedded on any domain.\n * `public` - The event can be embedded on any domain.\n * `whitelist` - The event can be embedded on whitelisted domains only.\n"
},
"unlisted_hash": {
"type": "string",
"example": "1a2b3c4d5e",
"nullable": true,
"description": "The hash for unlisted events."
}
},
"description": "The initial privacy settings of videos generated by streaming to the event as well as the embed privacy of the entire collection."
},
"auto_cc_enabled": {
"type": "boolean",
"nullable": true,
"description": "Whether the automated closed captions feature is enabled."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"nullable": true,
"description": "The password that anyone can use to access the videos generated by streaming to the event."
},
"streamable_clip": {
"type": "object",
"nullable": true,
"description": "The event's video. An event always has a video, which is either in a pre-live state (ready to be streamed to) or in a live state (which is currently being streamed to)."
},
"allow_share_link": {
"type": "boolean",
"example": true,
"description": "Whether the share link for the videos generated by streaming to the event is usable."
},
"auto_cc_keywords": {
"type": "string",
"nullable": true,
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"nullable": true,
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"allowed_privacies": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of privacy settings supported for this event and the requesting user."
},
"auto_cc_remaining": {
"type": "number",
"nullable": true,
"description": "The amount of time remaining to the user to access the automated closed captions feature."
},
"live_destinations": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "_This field is deprecated in favor of the following method:_ [Get all the destinations of a one-time live event](https://developer.vimeo.com/api/reference/live#get_one_time_event_destinations)."
},
"unlimited_auto_cc": {
"type": "boolean",
"nullable": true,
"description": "Whether to ignore the time limit of the automated closed captions feature."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"nullable": true,
"description": "The description of the next video streamed to the event."
},
"unlimited_duration": {
"type": "boolean",
"example": true,
"description": "Whether 24/7 streaming is enabled for the event."
},
"whitelisted_domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"allow_hd",
"domain",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/privacy/domains/example.com",
"description": "The URI of the domain."
},
"domain": {
"type": "string",
"example": "example.com",
"description": "The domain name."
},
"allow_hd": {
"type": "boolean",
"example": true,
"description": "Whether to permit HD embeds on this domain."
}
}
},
"nullable": true,
"description": "The domains on a video's whitelist."
},
"next_occurrence_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The date in ISO 8601 format on which the next occurrence of the event is expected to be live."
},
"preferred_stream_method": {
"enum": [
"browser",
"encoder"
],
"type": "string",
"example": "encoder",
"description": "The preferred streaming method.\n\nOption descriptions:\n * `browser` - Stream in the browser.\n * `encoder` - Stream by the encoder.\n"
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "When the value of this field is `true`, the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "array",
"items": {
"type": "object",
"required": [
"is_anonymous_questions_disabled",
"is_qna_moderated"
],
"properties": {
"is_qna_moderated": {
"type": "boolean",
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
}
},
"nullable": true,
"description": "The settings for the interaction tools."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the event."
},
"pictures": {
"description": "The active thumbnail image of the event."
},
"schedule": {
"description": "The description of the time or times that the event is expected to be live."
}
}
}
live-event-schedule
{
"type": "object",
"title": "Live Event Schedule",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "The schedule of the live event.\n\nOption descriptions:\n * `single` - The event is live only once.\n * `weekly` - The event is live on a recurring weekly basis.\n"
},
"rrule": {
"type": "string",
"description": "The recurrence rule for the event's schedule according to [RFC 5545](https://datatracker.ietf.org/doc/html/rfc5545)."
},
"end_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the live event is expected to end."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "When **schedule.type** is `weekly`, the weekdays in UTC when the event is expected to be live. The value of this field ranges from `1` to `7`, where `1` is Monday and `7` is Sunday."
},
"time_zone": {
"type": "string",
"description": "The time zone of the live event."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "When **schedule.type** is `weekly`, the time in ISO 8601 format when the event is expected to be live."
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The time in ISO 8601 format when the live event is expected to be live."
},
"scheduled_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "When **schedule.type** is `weekly`, the time in ISO 8601 format when the first occurrence of the event is expected to be live."
}
}
}
live-event-session-status
{
"type": "object",
"title": "Live Event Session Status",
"required": [
"archive",
"can_manage",
"id",
"ingest",
"metering",
"status",
"stream_mode"
],
"properties": {
"id": {
"type": "number",
"example": 1111,
"description": "The ID of the live video."
},
"ingest": {
"type": "object",
"required": [
"encoder_type",
"end_time",
"height",
"is_rtmp_session",
"is_scheduled_playback",
"rtmp_expires_at",
"rtmp_link",
"rtmps_link",
"scheduled_start_time",
"session_id",
"start_time",
"status",
"stream_ended_reason",
"stream_key",
"width"
],
"properties": {
"width": {
"type": "number",
"example": 100,
"nullable": true,
"description": "The width of the live video in pixels."
},
"height": {
"type": "number",
"example": 100,
"nullable": true,
"description": "The height of the live video in pixels."
},
"status": {
"enum": [
0,
1,
2,
3,
4,
5
],
"type": "integer",
"example": "1",
"nullable": true,
"description": "The ingest status of the live video.\n\nOption descriptions:\n * `0` - There’s a live video, but no RMTP URL or key.\n * `1` - There’s an RMTP URL and key, but the machine is provisioning.\n * `2` - There’s an RMTP URL and key, and the machine is provisioned, but the stream hasn’t started yet.\n * `3` - There’s an RMTP URL and key, and the machine is provisioned, but the stream didn’t start before the machine timed out.\n * `4` - The stream has started and is currently underway.\n * `5` - The stream has ended.\n"
},
"end_time": {
"type": "number",
"example": 1612451704,
"nullable": true,
"description": "The timestamp in UTC format when the live stream ended."
},
"rtmp_link": {
"type": "string",
"example": "rtmp://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMP link. Send your live content to this link to create a live video on the event."
},
"rtmps_link": {
"type": "string",
"example": "rtmps://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMPS link. Send your live content to this secure link to create a live video on the event."
},
"session_id": {
"type": "string",
"nullable": true,
"description": "The session ID."
},
"start_time": {
"type": "number",
"example": 1612451704,
"nullable": true,
"description": "The timestamp in UTC format when the live video started."
},
"stream_key": {
"type": "string",
"example": "ab9c8def-7a65-4321-b098-c7dd65e43f21",
"nullable": true,
"description": "The stream key used in conjunction with the RTMP and RTMPS links."
},
"encoder_type": {
"enum": [
"dash",
"rtmp",
"simple_live",
"studio_cloud",
"unknown",
"webrtc"
],
"type": "string",
"example": "rtmp",
"description": "The protocol used for this session.\n\nOption descriptions:\n * `dash` - The protocol is DASH.\n * `rtmp` - The protocol is RTMP.\n * `simple_live` - The protocol is Simplelive.\n * `studio_cloud` - The protocol is StudioCloud.\n * `unknown` - The protocol is unknown or not set.\n * `webrtc` - The protocol is WebRTC.\n"
},
"is_rtmp_session": {
"type": "boolean",
"example": true,
"description": "Whether the session is using RTMP."
},
"rtmp_expires_at": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the RTMP expires."
},
"stream_ended_reason": {
"type": "number",
"nullable": true,
"description": "The reason why the stream ended. If the stream hasn't ended, this field is empty."
},
"scheduled_start_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The scheduled start time of the live video in ISO 8601 format."
},
"is_scheduled_playback": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether the stream is scheduled media playback."
}
},
"description": "The ingest of the video."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"nullable": true,
"description": "The status of the live event.\n\nOption descriptions:\n * `ended` - The live event has ended.\n * `started` - The live event has started.\n"
},
"archive": {
"type": "object",
"required": [
"clip_id",
"status"
],
"properties": {
"status": {
"type": "number",
"example": 0,
"nullable": true,
"description": "The status of the archive data."
},
"clip_id": {
"type": "number",
"example": 1111,
"description": "The ID of the archived video."
}
},
"description": "Information about the archive data."
},
"metering": {
"type": "object",
"required": [
"seconds_max",
"seconds_remaining"
],
"properties": {
"seconds_max": {
"type": "number",
"example": 0,
"description": "The maximum number of seconds."
},
"seconds_remaining": {
"type": "number",
"example": 0,
"description": "The number of seconds remaining."
}
},
"description": "The metering status of the live video."
},
"can_manage": {
"type": "boolean",
"example": true,
"description": "Whether the current user can manage the event."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
}
}
}
location
{
"type": "object",
"title": "Location",
"required": [
"city",
"country",
"country_iso_code",
"formatted_address",
"latitude",
"longitude",
"neighborhood",
"state",
"state_iso_code",
"sub_locality"
],
"properties": {
"city": {
"type": "string",
"example": "New York City",
"nullable": true,
"description": "The authenticated user's city."
},
"state": {
"type": "string",
"example": "New York",
"nullable": true,
"description": "The authenticated user's state."
},
"country": {
"type": "string",
"example": "United States",
"nullable": true,
"description": "The authenticated user's country."
},
"latitude": {
"type": "number",
"example": 20.2960586,
"description": "The authenticated user's latitude."
},
"longitude": {
"type": "number",
"example": 185.8245392,
"description": "The authenticated user's longitude."
},
"neighborhood": {
"type": "string",
"example": "Brooklyn",
"nullable": true,
"description": "The authenticated user's neighborhood."
},
"sub_locality": {
"type": "string",
"example": "Brooklyn",
"nullable": true,
"description": "The authenticated user's sub-locality."
},
"state_iso_code": {
"type": "string",
"example": "NY",
"nullable": true,
"description": "The ISO code of the authenticated user's state."
},
"country_iso_code": {
"type": "string",
"example": "US",
"description": "The ISO code of the authenticated user's country."
},
"formatted_address": {
"type": "string",
"example": "123 Street, NY",
"description": "The authenticated user's formatted address string."
}
}
}
money
{
"type": "object",
"title": "Money",
"required": [
"amount",
"currency",
"formatted",
"unit"
],
"properties": {
"unit": {
"type": "number",
"example": 1200,
"description": "The amount expressed as a numeral in the lowest denomination. For example, 12 USD is expressed as 1200."
},
"amount": {
"type": "number",
"example": 12,
"description": "The amount expressed as a numeral without currency formatting."
},
"currency": {
"type": "string",
"example": "USD",
"description": "The currency in which the amount is expressed."
},
"formatted": {
"type": "string",
"example": "$12",
"description": "The amount expressed as a numeral with currency formatting."
}
}
}
on-demand-genre
{
"type": "object",
"title": "On Demand Genre",
"required": [
"canonical",
"interactions",
"link",
"metadata",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/genres/horror",
"description": "The relative URI of the On Demand genre."
},
"link": {
"type": "string",
"example": "http://vimeo.com/ondemand/browse/horror",
"description": "The Vimeo URL for the genre."
},
"name": {
"type": "string",
"example": "Horror",
"description": "The descriptive name of the genre."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"pages"
],
"properties": {
"pages": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/genres/horror/pages",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the On Demand pages related to this group."
}
},
"description": "A collection of information connected to this resource."
}
}
},
"canonical": {
"type": "string",
"example": "horror",
"description": "The canonical name or URL slug of the genre."
},
"interactions": {
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "object",
"required": [
"added",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/genres/horror/pages/12345",
"description": "The URI to access the On Demand page."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand genre was added."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Interactions for On Demand pages that belong to the genre."
}
}
}
}
}
on-demand-page
{
"type": "object",
"title": "On Demand Page",
"required": [
"background",
"colors",
"content_rating",
"description",
"domain_link",
"episodes",
"genres",
"link",
"metadata",
"name",
"pictures",
"preorder",
"published",
"rating",
"resource_key",
"subscription",
"theme",
"thumbnail",
"trailer",
"type",
"uri",
"user"
],
"properties": {
"sku": {
"type": "string",
"example": "VIME0001",
"nullable": true,
"description": "The creator-designated SKU for the On Demand page."
},
"uri": {
"type": "string",
"example": "/ondemand/pages/61326",
"description": "The relative URI of the On Demand page."
},
"film": {
"$ref": "#/components/schemas/video"
},
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever",
"description": "The link to the On Demand page."
},
"name": {
"type": "string",
"example": "Darby Forever",
"description": "The descriptive title of the On Demand page."
},
"type": {
"enum": [
"film",
"series"
],
"type": "string",
"example": "film",
"description": "Whether the On Demand page is for a film or a series.\n\nOption descriptions:\n * `film` - The On Demand page is for a film.\n * `series` - The On Demand page is for a series.\n"
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The user who created the On Demand page."
},
"theme": {
"type": "string",
"example": "vader",
"description": "The graphical theme for the On Demand page."
},
"colors": {
"type": "object",
"required": [
"primary",
"secondary"
],
"properties": {
"primary": {
"type": "string",
"example": "#0a0808",
"description": "The hexadecimal color code for the On Demand page's first color."
},
"secondary": {
"type": "string",
"example": "#ba4a17",
"description": "The hexadecimal color code for the On Demand page's second color."
}
},
"description": "The first and second colors of the On Demand page."
},
"genres": {
"type": "array",
"items": {
"$ref": "#/components/schemas/on-demand-genre"
},
"description": "An array of the genres assigned to the On Demand page."
},
"rating": {
"type": "number",
"example": 7,
"nullable": true,
"description": "The rating of the On Demand page."
},
"trailer": {
"allOf": [
{
"$ref": "#/components/schemas/video"
}
],
"nullable": true,
"description": "The trailer for the On Demand page."
},
"episodes": {
"type": "object",
"required": [
"buy",
"rent"
],
"properties": {
"buy": {
"type": "object",
"required": [
"active",
"price"
],
"properties": {
"price": {
"type": "number",
"example": 9.99,
"nullable": true,
"description": "The default price to buy an episode."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether all the videos on the On Demand page can be purchased as a whole."
}
}
},
"rent": {
"type": "object",
"required": [
"active",
"period",
"price"
],
"properties": {
"price": {
"type": "number",
"example": 2.99,
"nullable": true,
"description": "The default price to rent an episode."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether all the videos on the On Demand page can be rented as a whole."
},
"period": {
"enum": [
"1 day",
"1 month",
"1 week",
"1 year",
"2 day",
"24 hour",
"3 day",
"3 month",
"30 day",
"48 hour",
"6 month",
"60 day",
"7 day",
"72 hour"
],
"type": "string",
"example": "1 day",
"nullable": true,
"description": "The rental period for the video.\n\nOption descriptions:\n * `1 day` - The rental period is one day.\n * `1 month` - The rental period is one month.\n * `1 week` - The rental period is one week.\n * `1 year` - The rental period is one year.\n * `2 day` - The rental period is two days.\n * `24 hour` - The rental period is 24 hours.\n * `3 day` - The rental period is three days.\n * `3 month` - The rental period is three months.\n * `30 day` - The rental period is 30 days.\n * `48 hour` - The rental period is 48 hours.\n * `6 month` - The rental period is six months.\n * `60 day` - The rental period is 60 days.\n * `7 day` - The rental period is 7 days.\n * `72 hour` - The rental period is 72 hours.\n"
}
}
}
},
"description": "Information about the On Demand page's episodes, if the page is for a series."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"metadata"
],
"properties": {
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"comments",
"genres",
"likes",
"pictures",
"seasons",
"videos"
],
"properties": {
"likes": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/likes",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 15,
"description": "The total number of likes on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the likes associated with the On Demand page."
},
"genres": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/genres",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 9,
"description": "The total number of genres on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the genres associated with the On Demand page."
},
"videos": {
"type": "object",
"required": [
"extra_total",
"main_total",
"options",
"total",
"uri",
"viewable_total"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 50,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"main_total": {
"type": "number",
"example": 36,
"description": "The total number of main videos on the On Demand page."
},
"extra_total": {
"type": "number",
"example": 14,
"description": "The total number of extra videos on the On Demand page."
},
"viewable_total": {
"type": "number",
"example": 50,
"description": "The total number of viewable videos on the On Demand page."
}
},
"description": "Information about the videos associated with the On Demand page."
},
"seasons": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/seasons",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 3,
"description": "The total number of seasons on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the seasons associated with the On Demand page."
},
"comments": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/comments",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of comments on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the comments associated with the On Demand page."
},
"pictures": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/pictures",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 3,
"description": "The total number of pictures on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the pictures associated with the On Demand page."
}
}
}
}
}
},
"description": "A collection of information that is connected to this resource, including videos, genres, and pictures connections."
},
"interactions": {
"$ref": "#/components/schemas/purchase-interaction"
}
},
"description": "Metadata about the On Demand page.",
"x-konfig-properties": {
"interactions": {
"description": "The user's available purchase interactions."
}
}
},
"pictures": {
"allOf": [
{
"$ref": "#/components/schemas/picture"
}
],
"nullable": true,
"description": "The active poster for the On Demand page."
},
"preorder": {
"type": "object",
"required": [
"active",
"cancel_time",
"publish_time",
"time"
],
"properties": {
"time": {
"type": "string",
"example": "2017-05-15T13:13:31+00:00",
"description": "The time in ISO 8601 format when the preorder started."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand page is available for preorder."
},
"cancel_time": {
"type": "string",
"example": "2017-05-16T13:13:46+00:00",
"description": "The time in ISO 8601 format when the preorder was cancelled."
},
"publish_time": {
"type": "string",
"example": "2017-05-15T13:12:52+00:00",
"description": "The time in ISO 8601 format when the preorder was released to the public."
}
}
},
"published": {
"type": "object",
"required": [
"enabled",
"time"
],
"properties": {
"time": {
"type": "string",
"example": "2017-05-15T13:12:52+00:00",
"description": "The time in ISO 8601 format when this page was published."
},
"enabled": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand page has been published."
}
}
},
"thumbnail": {
"allOf": [
{
"$ref": "#/components/schemas/picture"
}
],
"nullable": true,
"description": "The thumbnail image for the On Demand page."
},
"background": {
"allOf": [
{
"$ref": "#/components/schemas/picture"
}
],
"nullable": true,
"description": "The background image for the On Demand page."
},
"description": {
"type": "string",
"example": "DARBY FOREVER follows the fantasies of Darby, a shopgirl at \"Bobbins & Notions\"",
"nullable": true,
"description": "The description of the On Demand page."
},
"domain_link": {
"type": "string",
"example": "https://example.com",
"nullable": true,
"description": "The link to the On Demand page on its own domain."
},
"created_time": {
"type": "string",
"example": "2017-05-15T13:42:25+00:00",
"description": "The time in ISO 8601 format when the On Demand page was created."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The On Demand resource key."
},
"subscription": {
"type": "object",
"nullable": true,
"required": [
"active",
"link",
"price"
],
"properties": {
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever",
"nullable": true,
"description": "The link to the On Demand product."
},
"price": {
"type": "object",
"description": "The accepted currencies and respective pricing for the On Demand product."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand product is active."
},
"period": {
"type": "string",
"description": "The On Demand product's rental period."
}
},
"description": "Information about subscribing to the On Demand page, if subscription is enabled."
},
"modified_time": {
"type": "string",
"example": "2017-05-15T13:42:25+00:00",
"description": "The time in ISO 8601 format when the On Demand page was last modified."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the On Demand page's content ratings."
}
},
"x-konfig-properties": {
"film": {
"description": "The On Demand page's film, if the page is for a film."
}
}
}
on-demand-promotion
{
"type": "object",
"title": "On Demand Promotion",
"required": [
"access_type",
"discount_type",
"download",
"label",
"metadata",
"percent_off",
"product_type",
"stream_period",
"total",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/promotions/12345",
"description": "The promotion's canonical relative URI."
},
"type": {
"enum": [
"batch",
"batch_prefix",
"single"
],
"type": "string",
"example": "batch",
"description": "The way in which the promotion generates promo codes.\n\nOption descriptions:\n * `batch` - The promotion provides a unique promo code for each user.\n * `batch_prefix` - Like `batch`, except that all codes have a similar prefix string. _This option is deprecated, yet it may still appear for some users._\n * `single` - The promotion provides a single promo code for all users.\n"
},
"label": {
"type": "string",
"example": "8jgaieumbzstujhn8k304iwwezawkvwm",
"nullable": true,
"description": "The prefix string for batch codes, or the null value for single codes."
},
"total": {
"type": "number",
"example": 1,
"description": "When **type** is `single`, the total number of times that the promotion can be used. When **type** is `batch` or `batch_prefix`, the total number of promo codes that have been generated."
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether the promotion grants download access to On Demand content."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"codes"
],
"properties": {
"codes": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/promotion/12345/codes",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 1,
"description": "The total number of uses on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the codes associated with the promotion."
}
},
"description": "A list of resource URIs related to the promotion."
}
},
"description": "The video's metadata."
},
"access_type": {
"enum": [
"default",
"vip"
],
"type": "string",
"example": "default",
"description": "The type of access that the promotion grants.\n\nOption descriptions:\n * `default` - The promotion grants discounts on existing product offerings.\n * `vip` - The promotion grants free access to On Demand content before it's released, or to access types that aren't part of the existing product offerings.\n"
},
"percent_off": {
"type": "number",
"example": 100,
"description": "When **discount_type** is `percent`, the percentage amount that is deducted from the product price."
},
"product_type": {
"enum": [
"any",
"buy",
"buy_episode",
"rent",
"rent_episode",
"subscribe"
],
"type": "string",
"example": "any",
"description": "The type of product to which the promotion can be applied. Only the `buy` and `rent` options are available when **access_type** is `vip`.\n\nOption descriptions:\n * `any` - The promotion can be applied to any product.\n * `buy` - The promotion can be applied to a buyable single video.\n * `buy_episode` - The promotion can be applied to a buyable single episode.\n * `rent` - The promotion can be applied to a rentable single video.\n * `rent_episode` - The promotion can be applied to a rentable single episode.\n * `subscribe` - The promotion can be applied to a subscription.\n"
},
"discount_type": {
"enum": [
"dollars",
"free",
"percent"
],
"type": "string",
"example": "free",
"description": "The type of discount that the promotion provides.\n\nOption descriptions:\n * `dollars` - The promotion discounts a fixed amount from the full purchase price.\n * `free` - The promotion discounts the full purchase price. When **access_type** is `vip`, **discount_type** is always `free`.\n * `percent` - The promotion discounts a percentage of the full purchase price.\n"
},
"stream_period": {
"enum": [
"1_week",
"1_year",
"24_hour",
"30_days",
"3_month",
"48_hour",
"6_month",
"72_hour"
],
"type": "string",
"example": "1_week",
"nullable": true,
"description": "The amount of time that the user has access to the On Demand content after redeeming a promo code.\n\nOption descriptions:\n * `1_week` - Access lasts for one week.\n * `1_year` - Access lasts for one year.\n * `24_hour` - Access lasts for 24 hours.\n * `30_days` - Access lasts for 30 days.\n * `3_month` - Access lasts for three months.\n * `48_hour` - Access lasts for 48 hours.\n * `6_month` - Access lasts for six months.\n * `72_hour` - Access lasts for 72 hours.\n"
}
}
}
on-demand-promotion-code
{
"type": "object",
"title": "On Demand Promotion Code",
"required": [
"code",
"link",
"max_uses",
"uses"
],
"properties": {
"code": {
"type": "string",
"example": "8jgaieumbzstujhn8k304iwwezawkvwm",
"description": "The Vimeo promotion code."
},
"link": {
"type": "string",
"example": "https://vimeo.com/r/0trBLg/OGpnYWlldW",
"description": "The link to redeem the promotion code."
},
"uses": {
"type": "number",
"example": 0,
"description": "The current number of times that this code has been used."
},
"max_uses": {
"type": "number",
"example": 1,
"description": "The total number of times that this code can be used."
}
}
}
on-demand-region
{
"type": "object",
"title": "On Demand Region",
"required": [
"country_code",
"country_name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/regions/US",
"description": "The region container's relative URI."
},
"country_code": {
"type": "string",
"example": "US",
"description": "The ISO 3166-1 alpha-2 code for this country."
},
"country_name": {
"type": "string",
"example": "United States",
"description": "The descriptive name of this country."
}
}
}
on-demand-season
{
"type": "object",
"title": "On Demand Season",
"required": [
"description",
"metadata",
"name",
"position",
"resource_key",
"type",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/seasons/12345",
"description": "The season container's relative URI."
},
"name": {
"type": "string",
"example": "Season 1",
"description": "The name of the season."
},
"type": {
"type": "string",
"example": "main",
"description": "The type of the season."
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The creator of the season's On Demand page."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/season/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 13,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The connection to the associated videos."
}
}
}
}
},
"position": {
"type": "number",
"example": 1,
"description": "The position of the season relative to other seasons in the series."
},
"description": {
"type": "string",
"example": "Season 1",
"description": "The description of the season."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The unique identifier of the On Demand season."
}
}
}
on-demand-video
{
"type": "object",
"title": "On Demand Video",
"required": [
"buy",
"interactions",
"link",
"metadata",
"play_progress",
"release_year",
"rent",
"type",
"uri"
],
"properties": {
"buy": {
"type": "object",
"nullable": true,
"required": [
"active",
"price"
],
"properties": {
"price": {
"type": "object",
"description": "A map of currency type to price."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be purchased."
},
"purchased": {
"type": "boolean",
"example": true,
"description": "Whether the video has been purchased."
}
},
"description": "Information about purchasing the video."
},
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/videos/12345",
"description": "The video container's relative URI."
},
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever/12345",
"description": "The link to the video on Vimeo."
},
"name": {
"type": "string",
"example": "Darby Forever",
"description": "The title of the video."
},
"rent": {
"type": "object",
"nullable": true,
"required": [
"active",
"price"
],
"properties": {
"price": {
"type": "object",
"description": "A map of currency type to price."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video can be rented."
},
"purchased": {
"type": "boolean",
"example": true,
"description": "Whether the video has been rented."
}
},
"description": "Information about renting the video."
},
"type": {
"enum": [
"extra",
"main",
"trailer"
],
"type": "string",
"example": "main",
"description": "The type of video.\n\nOption descriptions:\n * `extra` - The video is an extra feature.\n * `main` - The video is a main feature.\n * `trailer` - The video is a trailer.\n"
},
"user": {
"$ref": "#/components/schemas/user"
},
"episode": {
"type": "number",
"example": 1,
"description": "The episode number of the video."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"duration": {
"type": "string",
"example": "1197",
"description": "The duration of the video."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"season"
],
"properties": {
"season": {
"type": "object",
"required": [
"name",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/seasons/12345",
"description": "The API URI that resolves to the connection data."
},
"name": {
"type": "string",
"example": "Season 1",
"description": "The name of the season on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video's season."
}
}
},
"interactions": {
"type": "object",
"required": [
"likes",
"watchlater"
],
"properties": {
"likes": {
"type": "object",
"required": [
"added",
"added_time",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/likes/12345",
"description": "The URI for the authenticated user to like the video."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user has liked the video."
},
"added_time": {
"type": "string",
"example": "2017-05-12T21:42:42+00:00",
"description": "The time in ISO 8601 format when the authenticated user liked the video."
}
},
"description": "Information about the authenticated user's interaction to like the video."
},
"watchlater": {
"type": "object",
"required": [
"added",
"added_time",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/watchlater/12345",
"description": "The URI for the authenticated user to add the video to their Watch Later queue."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user has added the video to their Watch Later queue."
},
"added_time": {
"type": "string",
"example": "2017-05-12T21:42:42+00:00",
"description": "The time in ISO 8601 format when the authenticated user added the video to their Watch Later queue."
}
},
"description": "Information about the authenticated user's interaction to watch the video later."
}
}
}
},
"description": "Metadata information about the video."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"position": {
"type": "number",
"example": 1,
"description": "The position of the video relative to the other videos on the On Demand page."
},
"description": {
"type": "string",
"example": "This video provides in-depth instruction in the use of the Vimeo API.",
"description": "The description of the video."
},
"interactions": {
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "object",
"required": [
"added",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326",
"description": "The URI to access the On Demand page."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand page was added."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about how the authenticated user can interact with the connection to the video's On Demand page."
}
},
"description": "An object containing information about how the authenticated user can interact with the video's On Demand page."
},
"release_date": {
"type": "string",
"example": "2017-05-12T21:06:42+00:00",
"description": "The time in ISO 8601 format when the video was created or published."
},
"release_year": {
"type": "number",
"example": 2016,
"nullable": true,
"description": "The year that the video was released."
},
"play_progress": {
"type": "number",
"example": 30,
"description": "The authenticated user's most recent play position in the video, in seconds."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the video."
},
"pictures": {
"description": "The active picture of the video."
}
}
}
ott-destination
{
"type": "object",
"title": "OTT Destination",
"required": [
"id",
"ott_channel_id",
"ott_channel_name",
"ott_channel_subdomain",
"ott_event_id",
"recurring_live_event_id"
],
"properties": {
"id": {
"type": "string",
"example": "/ott/destination/1111",
"description": "The OTT destination's canonical relative URI."
},
"ott_event_id": {
"type": "number",
"example": 1111,
"description": "The ID of the OTT event."
},
"ott_channel_id": {
"type": "number",
"example": 1111,
"description": "The ID of the OTT channel."
},
"ott_channel_name": {
"type": "string",
"example": "Channel One",
"description": "The name of the OTT channel."
},
"ott_channel_subdomain": {
"type": "string",
"example": "subdomain",
"description": "The subdomain of the OTT channel."
},
"recurring_live_event_id": {
"type": "number",
"example": 1111,
"description": "The ID of the current recurring live event."
}
}
}
payment-method
{
"type": "object",
"title": "Payment Method",
"required": [
"account_id",
"created_at",
"disabled_at",
"id",
"is_default",
"type",
"updated_at"
],
"properties": {
"id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the payment method."
},
"card": {
"type": "object",
"properties": {
"bin": {
"type": "string",
"example": "123456",
"description": "The bank identification number of the card."
},
"brand": {
"type": "string",
"example": "Visa",
"description": "The brand of the card."
},
"billing_address": {
"type": "object",
"properties": {
"city": {
"type": "string",
"example": "New York",
"description": "The city of the billing address."
},
"state": {
"type": "string",
"example": "NY",
"description": "The state of the billing address."
},
"address": {
"type": "string",
"example": "123 Main St.",
"description": "The street address of the billing address."
},
"country": {
"type": "string",
"example": "US",
"description": "The country of the billing address."
},
"postal_code": {
"type": "string",
"example": "10001",
"description": "The postal code of the billing address."
}
},
"description": "The billing address of the card."
},
"cardholder_name": {
"type": "string",
"example": "John Doe",
"description": "The name of the cardholder."
},
"expiration_year": {
"type": "number",
"example": 2020,
"description": "The expiration year of the card."
},
"expiration_month": {
"type": "number",
"example": 1,
"description": "The expiration month of the card."
},
"last_four_digits": {
"type": "string",
"example": "1234",
"description": "The last four digits of the card."
}
},
"description": "Information about the card used to make the payment."
},
"type": {
"enum": [
"PAYMENT_METHOD_TYPES_APPLEPAY",
"PAYMENT_METHOD_TYPES_BANK_ACCOUNT",
"PAYMENT_METHOD_TYPES_CARD",
"PAYMENT_METHOD_TYPES_GOOGLEPAY",
"PAYMENT_METHOD_TYPES_PAYPAL",
"PAYMENT_METHOD_TYPES_TYPES_UNSPECIFIED"
],
"type": "string",
"example": "PAYMENT_METHOD_TYPES_CARD",
"description": "The type of payment method.\n\nOption descriptions:\n * `PAYMENT_METHOD_TYPES_APPLEPAY` - The payment method is Apple Pay.\n * `PAYMENT_METHOD_TYPES_BANK_ACCOUNT` - The payment method is a bank account.\n * `PAYMENT_METHOD_TYPES_CARD` - The payment method is a card.\n * `PAYMENT_METHOD_TYPES_GOOGLEPAY` - The payment method is Google Pay.\n * `PAYMENT_METHOD_TYPES_PAYPAL` - The payment method is a PayPal account.\n * `PAYMENT_METHOD_TYPES_TYPES_UNSPECIFIED` - The payment method type is unspecified.\n"
},
"account_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the account."
},
"created_at": {
"type": "string",
"example": "2019-01-01T00:00:00+00:00",
"description": "The time when the payment method was created."
},
"is_default": {
"type": "boolean",
"example": true,
"description": "Whether the payment method is the default payment method for the account."
},
"updated_at": {
"type": "string",
"example": "2019-01-01T00:00:00+00:00",
"description": "The time when the payment method was last updated."
},
"disabled_at": {
"type": "string",
"example": "2019-01-01T00:00:00+00:00",
"description": "The time when the payment method was disabled."
}
}
}
permission-policy
{
"type": "object",
"title": "Permission Policy",
"required": [
"created_on",
"display_description",
"display_name",
"modified_on",
"name",
"permission_actions",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/12345/permission_policies/56789",
"description": "The URI of the permission policy."
},
"name": {
"type": "string",
"description": "The name of the permission policy."
},
"created_on": {
"type": "string",
"description": "The time at which the permission policy was created."
},
"modified_on": {
"type": "string",
"nullable": true,
"description": "The time at which the permission policy was last modified."
},
"display_name": {
"type": "string",
"description": "The display name of the permission policy, translated where applicable."
},
"permission_actions": {
"type": "object",
"description": "The permission actions associated with the policy."
},
"display_description": {
"type": "string",
"description": "The display description of the permission policy, translated where applicable."
}
}
}
picture
{
"type": "object",
"title": "Picture",
"required": [
"active",
"base_link",
"default_picture",
"resource_key",
"sizes",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/pictures/12345",
"description": "The URI of the picture."
},
"link": {
"type": "string",
"description": "The upload URL of the picture. This field appears upon the initial creation of a picture resource."
},
"type": {
"enum": [
"caution",
"custom",
"default"
],
"type": "string",
"example": "caution",
"description": "The type of picture.\n\nOption descriptions:\n * `caution` - The picture isn't appropriate for all ages.\n * `custom` - The picture is a custom video image.\n * `default` - The picture is the default video image.\n"
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"height",
"link",
"width"
],
"properties": {
"link": {
"type": "string",
"example": "https://i.vimeocdn.com/video/581495283_1280x720?r=pad&subrect=0,12,21,22&r=cover",
"description": "The direct link to the image file. For information about the format of the image file, see our [Working with Thumbnail Uploads](https://developer.vimeo.com/api/upload/thumbnails#returning-the-link-to-a-thumbnail) guide."
},
"width": {
"type": "number",
"example": 1280,
"description": "The width of the picture."
},
"height": {
"type": "number",
"example": 720,
"nullable": true,
"description": "The height of the picture."
},
"link_with_play_button": {
"type": "string",
"example": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F581495283_1280x720&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png",
"description": "The direct link to the image file with a play button overlay. For information about the format of the image file, see our [Working with Thumbnail Uploads](https://developer.vimeo.com/api/upload/thumbnails#returning-the-link-to-a-thumbnail) guide."
}
}
},
"description": "An array containing reference information about all available image files."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the picture is currently active."
},
"base_link": {
"type": "string",
"example": "https://i.vimeocdn.com/video/1130929417-276se668248611ce41e6f7d438196e3412863bad9a5c3bcaf1a14453454cc5-d",
"description": "The base link to the image file, without any parameters."
},
"resource_key": {
"type": "string",
"example": "dc724af18fbdd4e59189f5fe768a5f8311527050",
"description": "The resource key string of the picture."
},
"default_picture": {
"type": "boolean",
"example": false,
"description": "Whether the picture is Vimeo's default."
}
}
}
play
{
"type": "object",
"title": "Play",
"required": [
"status"
],
"properties": {
"hls": {
"$ref": "#/components/schemas/hls-dash-video-file"
},
"dash": {
"$ref": "#/components/schemas/hls-dash-video-file"
},
"status": {
"enum": [
"playable",
"purchase_required",
"restricted",
"unavailable"
],
"type": "string",
"example": "playable",
"description": "The play status of the video.\n\nOption descriptions:\n * `playable` - The video is playable.\n * `purchase_required` - The video must be purchased.\n * `restricted` - Playback for the video is restricted.\n * `unavailable` - The video is unavailable.\n"
},
"progressive": {
"type": "array",
"items": {
"type": "object",
"required": [
"codec",
"created_time",
"fps",
"height",
"link",
"link_expiration_time",
"md5",
"rendition",
"size",
"type",
"width"
],
"properties": {
"fps": {
"type": "number",
"example": 30,
"description": "The frames per second of the video."
},
"log": {
"type": "object",
"description": "The URLs for logging events."
},
"md5": {
"type": "string",
"example": "1bc29b36f623ba82aaf6724fd3b16718",
"description": "The MD5 hash of the video file."
},
"link": {
"type": "string",
"description": "The direct link to the video file."
},
"size": {
"type": "number",
"example": 5000000,
"nullable": true,
"description": "The size in bytes of the video file."
},
"type": {
"enum": [
"source",
"video/mp4",
"video/webm",
"vp6/x-video"
],
"type": "string",
"example": "source",
"nullable": true,
"description": "The type of video file.\n\nOption descriptions:\n * `source` - The video file is a source file.\n * `video/mp4` - The video file is in MP4 format.\n * `video/webm` - The video file is in WebM format.\n * `vp6/x-video` - The video file is in VP6 format.\n"
},
"codec": {
"enum": [
"AV1",
"H264",
"HEVC"
],
"type": "string",
"example": "AV1",
"nullable": true,
"description": "The codec of the video file.\n\nOption descriptions:\n * `AV1` - The codec is AV1.\n * `H264` - The codec is H264.\n * `HEVC` - The codec is HEVC.\n"
},
"width": {
"type": "number",
"example": 1280,
"nullable": true,
"description": "The width of the video in pixels."
},
"height": {
"type": "number",
"example": 720,
"nullable": true,
"description": "The height of the video in pixels."
},
"rendition": {
"enum": [
"1080p",
"240p",
"2k",
"360p",
"480p",
"4k",
"540p",
"5k",
"6k",
"720p",
"7k",
"8k"
],
"type": "string",
"example": "1080p",
"description": "The video rendition.\n\nOption descriptions:\n * `1080p` - The video has 1080p resolution.\n * `240p` - The video has 240p resolution.\n * `2k` - The video has 2K resolution.\n * `360p` - The video has 360p resolution.\n * `480p` - The video has 480p resolution.\n * `4k` - The video has 4K resolution.\n * `540p` - The video has 540p resolution.\n * `5k` - The video has 5K resolution.\n * `6k` - The video has 6K resolution.\n * `720p` - The video has 720p resolution.\n * `7k` - The video has 7K resolution.\n * `8k` - The video has 8K resolution.\n"
},
"created_time": {
"type": "string",
"example": "2017-05-16T17:21:51+00:00",
"description": "The time in ISO 8601 format when the video file was created."
},
"link_expiration_time": {
"type": "string",
"example": "2017-05-16T17:21:51+00:00",
"description": "The time in ISO 8601 format when the link to the video file expires."
}
}
},
"description": "The progressive video files."
}
},
"x-konfig-properties": {
"hls": {
"description": "The HLS video file."
},
"dash": {
"description": "The DASH video file."
}
}
}
portfolio
{
"type": "object",
"title": "Portfolio",
"required": [
"created_time",
"description",
"link",
"metadata",
"modified_time",
"name",
"sort",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/portfolios/12345",
"description": "The canonical relative URI of the portfolio."
},
"link": {
"type": "string",
"example": "https://vimeopro.com/staff/originals",
"description": "The link to the portfolio."
},
"name": {
"type": "string",
"example": "Vimeo Originals!",
"description": "The display name of the portfolio."
},
"sort": {
"enum": [
"alphabetical",
"clips",
"modified",
"recent"
],
"type": "string",
"example": "alphabetical",
"description": "The default video sort order of the portfolio.\n\nOption descriptions:\n * `alphabetical` - The default sort order is alphabetical by name.\n * `clips` - The default sort order is video creation date.\n * `modified` - The default sort order is the order in which the videos were modified.\n * `recent` - The default sort order is the order in which the videos were added.\n"
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/portfolios/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 18,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos contained within the portfolio."
}
},
"description": "A list of resource URIs related to the portfolio."
}
},
"description": "Metadata about the portfolio."
},
"description": {
"type": "string",
"example": "The Vimeo Staff original productions.",
"nullable": true,
"description": "The description of the portfolio."
},
"created_time": {
"type": "string",
"example": "2017-05-16T19:56:07+00:00",
"description": "The time in ISO 8601 format when the portfolio was created."
},
"modified_time": {
"type": "string",
"example": "2017-05-17T19:56:07+00:00",
"description": "The time in ISO 8601 format when the portfolio's data was last modified."
}
}
}
preset
{
"type": "object",
"title": "Preset",
"required": [
"metadata",
"name",
"settings",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/presets/12345",
"description": "The canonical relative URI of the preset object."
},
"name": {
"type": "string",
"example": "Minimalism",
"description": "The display name of the preset group."
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The owner of the preset."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/presets/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 13,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos in the preset."
}
},
"description": "A list of resource URIs related to the preset."
}
},
"description": "Metadata about the preset."
},
"settings": {
"type": "object",
"required": [
"airplay",
"ask_ai",
"audio_tracks",
"buttons",
"byline",
"chapters",
"chromecast",
"closed_captions",
"color",
"colors",
"logos",
"outro",
"pip",
"play_button",
"playbar",
"portrait",
"quality_selector",
"speed",
"title",
"transcript",
"volume"
],
"properties": {
"pip": {
"type": "boolean",
"example": true,
"description": "Whether picture-in-picture is enabled and the button appears in the embeddable player."
},
"color": {
"type": "string",
"example": "#0a0808",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"logos": {
"type": "object",
"required": [
"custom",
"sticky_custom",
"vimeo"
],
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes Vimeo logo settings."
},
"custom": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes custom logo settings."
},
"sticky_custom": {
"type": "boolean",
"example": true,
"description": "Whether the present includes sticky custom logo settings."
}
}
},
"outro": {
"type": "object",
"required": [
"type"
],
"properties": {
"link": {
"type": "object",
"nullable": true,
"properties": {
"url": {
"type": "string",
"example": "https://example.com",
"description": "The URL of the outro link."
},
"name": {
"type": "string",
"example": "Example Outro",
"description": "The name of the outro link."
}
},
"description": "The outro link settings. These fields appear only when **type** is `link`."
},
"text": {
"type": "string",
"example": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
"nullable": true,
"description": "The outro text. This appears only when **type** is `text`."
},
"type": {
"enum": [
"link",
"no idea",
"text",
"uploaded_clips",
"uploaded_videos"
],
"type": "string",
"example": "link",
"description": "The preset outro type.\n\nOption descriptions:\n * `link` - The outro includes a link.\n * `no idea` - The outro type is `no idea`. The outro includes uploaded videos.\n * `text` - The outro includes text.\n * `uploaded_clips` - The outro includes uploaded videos.\n * `uploaded_videos` - The outro includes uploaded videos.\n"
},
"clips": {
"type": "string",
"example": "/videos/258684937,/videos/273576296",
"nullable": true,
"description": "A comma-separated list of video URIs. This field appears only when **type** is `uploaded_clips`."
},
"videos": {
"type": "string",
"example": "/videos/258684937,/videos/273576296",
"nullable": true,
"description": "A comma-separated list of video URIs. This field appears only when **type** is `no idea`."
}
}
},
"speed": {
"type": "boolean",
"example": true,
"description": "Whether the speed controls appear in the embeddable player."
},
"title": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video title.\n\nOption descriptions:\n * `hide` - The title is hidden.\n * `show` - The title is shown.\n * `user` - The title can be toggled to `show` or `hide` by the user.\n"
},
"ask_ai": {
"type": "boolean",
"example": true,
"description": "Whether Ask AI is enabled in the embeddable player."
},
"byline": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video owner's information.\n\nOption descriptions:\n * `hide` - The owner's information is hidden.\n * `show` - The owner's information is shown.\n * `user` - The owner's information can be toggled to `show` or `hide` by the user.\n"
},
"colors": {
"type": "object",
"required": [
"color_four",
"color_one",
"color_three",
"color_two"
],
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The third player color, which controls the color of text and icons."
}
}
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether the volume controls appear in the embeddable player."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"buttons": {
"type": "object",
"required": [
"embed",
"fullscreen",
"hd",
"like",
"reaction",
"share",
"vote",
"watchlater"
],
"properties": {
"hd": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `HD` button settings."
},
"like": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `Like` button settings."
},
"vote": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `Vote` button settings."
},
"embed": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `Embed` button settings."
},
"share": {
"type": "boolean",
"example": true,
"description": "Whether the present includes `Share` button settings."
},
"reaction": {
"type": "boolean",
"example": true,
"nullable": true,
"description": "Whether the preset includes `Reaction` button settings."
},
"fullscreen": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `Fullscreen` button settings."
},
"watchlater": {
"type": "boolean",
"example": true,
"description": "Whether the preset includes `Watch Later` button settings."
}
}
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether the playbar appears in the embeddable player."
},
"chapters": {
"type": "boolean",
"example": true,
"description": "Whether chapters are enabled in the embeddable player."
},
"portrait": {
"enum": [
"hide",
"show",
"user"
],
"type": "string",
"example": "hide",
"description": "How the embeddable player handles the video owner's portrait.\n\nOption descriptions:\n * `hide` - The owner's portrait is hidden.\n * `show` - The owner's portrait is shown.\n * `user` - The owner's portrait can be toggled to `show` or `hide` by the user.\n"
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"transcript": {
"type": "boolean",
"example": true,
"description": "Whether the transcript controls appear in the embeddable player."
},
"play_button": {
"type": "object",
"required": [
"position"
],
"properties": {
"position": {
"enum": [
"auto",
"bottom",
"center"
],
"type": "string",
"example": "auto",
"description": "The position of the play button within the embeddable player.\n\nOption descriptions:\n * `auto` - Use Vimeo's default positioning for the play button.\n * `bottom` - The play button is positioned at the bottom of the player, except when in tiny mode.\n * `center` - The play button is positioned in the center of the player.\n"
}
},
"description": "A representation of the play button's settings."
},
"audio_tracks": {
"type": "boolean",
"example": true,
"description": "Whether multiple audio tracks can appear in the embeddable player."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"quality_selector": {
"type": "boolean",
"example": true,
"description": "Whether to show the quality selector in the embeddable player."
}
},
"description": "The contents of the preset group."
}
}
}
project
{
"type": "object",
"title": "Project",
"required": [
"access_grant",
"created_time",
"creator_uri",
"has_subfolder",
"is_pinned",
"is_private_to_user",
"last_user_action_event_date",
"link",
"manage_link",
"metadata",
"modified_time",
"name",
"pinned_on",
"privacy",
"resource_key",
"settings",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/112233/projects/12345",
"description": "The URI of the folder."
},
"link": {
"type": "string",
"example": "https://vimeo.com/user/112233/folders/12345",
"description": "The link to the folder on Vimeo."
},
"name": {
"type": "string",
"example": "Rough cuts",
"description": "The name of the folder."
},
"user": {
"$ref": "#/components/schemas/user"
},
"privacy": {
"type": "object",
"required": [
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"team"
],
"type": "string",
"example": "anybody",
"description": "The privacy setting for accessing the folder.\n\nOption descriptions:\n * `anybody` - Anyone with the link can access the contents of the folder. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - Only the owner and those team members that the owner has explicitly invited can access the contents of the folder. This privacy setting appears as `Private` on the Vimeo front end.\n * `team` - Only those team members with the link can access the contents of the folder.\n"
}
},
"description": "The privacy settings of the folder."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"ancestor_path",
"data_retention",
"folders",
"group_folder_grants",
"items",
"parent_folder",
"personal_team_folder_owner",
"resource_creator_team_user",
"team_permissions",
"user_folder_access_grants",
"videos"
],
"properties": {
"items": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/12345/items",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12,
"description": "The total number of items on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "A standard connection object indicating how to return all the items in the folder."
},
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "A standard connection object indicating how to return all the videos in the folder."
},
"folders": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/12345/items",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12,
"description": "The total number of subfolders on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "A standard connection object indicating how to return all the subfolders in the folder."
},
"ancestor_path": {
"type": "array",
"items": {
"type": "object",
"required": [
"can_upload",
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/112233/projects/12345",
"description": "The URI of the ancestor folder."
},
"name": {
"type": "string",
"description": "The name of the folder."
},
"can_upload": {
"type": "boolean",
"description": "Whether the user can upload to this ancestor folder."
}
}
},
"description": "Information about the folder's ancestry ordered from the direct parent to higher-level ancestors."
},
"parent_folder": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/12345/items",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "A standard connection object indicating how to return the folder's parent folder."
},
"data_retention": {
"type": "object",
"required": [
"policy"
],
"properties": {
"policy": {
"type": "object",
"required": [
"options",
"title",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/teams/112233/data_retention/policies/12345",
"description": "The URI of the data retention policy. This data requires a bearer token with the `private` scope."
},
"title": {
"type": "string",
"example": "Policy title",
"description": "The title of the data retention policy. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the folder's data retention policy. This data requires a bearer token with the `private` scope."
}
}
},
"team_permissions": {
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the folder's team permissions list. This data requires a bearer token with the `private` scope."
},
"group_folder_grants": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/folders/98765/group_folder_grants",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 5,
"description": "The total number of group access grants on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the folder's group access grants."
},
"user_folder_access_grants": {
"type": "object",
"required": [
"folder_permission_policies",
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/folders/98765/user_folder_access_grants",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 5,
"description": "The total number of user folder access grants on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"folder_permission_policies": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/permission_policies/12345",
"description": "The permission policy's API URI."
},
"name": {
"type": "string",
"example": "Folder Viewer",
"description": "The permission policy's name."
}
}
},
"description": "Information about the owner's folder permission policies."
}
},
"description": "Information about the folder's user folder access grants."
},
"personal_team_folder_owner": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/112233",
"description": "The URI of the owner of the personal team folder."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the owner of the personal team folder."
},
"resource_creator_team_user": {
"type": "object",
"required": [
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The URI for the team user who created the folder. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the team user who created the folder. This data requires a bearer token with the `private` scope."
}
},
"description": "A list of resource URIs related to the folder."
},
"interactions": {
"type": "object",
"required": [
"add_subfolder",
"delete",
"delete_video",
"edit",
"edit_settings",
"invite",
"move_video",
"upload_video",
"view"
],
"properties": {
"edit": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's edit permissions information for this project."
},
"view": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's view permissions information for this project."
},
"delete": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/46345352",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's delete permissions information for this project."
},
"invite": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's invite permissions information for this project."
},
"move_video": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's move permissions information for this project."
},
"delete_video": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's delete permissions information for this project."
},
"upload_video": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's upload permissions information for this project."
},
"add_subfolder": {
"type": "object",
"required": [
"can_add_subfolders",
"subfolder_depth_limit_reached"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Properties that can be added to the request body."
},
"content_type": {
"type": "string",
"description": "The subfolder content type."
},
"can_add_subfolders": {
"type": "boolean",
"description": "Whether the folder can contain a subfolder."
},
"subfolder_depth_limit_reached": {
"type": "boolean",
"description": "Whether the user has reached the maximum subfolder depth."
}
},
"description": "Information about adding a subfolder to the current folder."
},
"edit_settings": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/projects/46345352",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The user's edit settings permissions information for this project."
}
},
"description": "A list of permitted interactions related to the folder."
}
},
"description": "Information about the folders's metadata."
},
"settings": {
"type": "object",
"required": [
"color",
"folder_uri"
],
"properties": {
"color": {
"type": "string",
"example": "#c0c0c0",
"description": "The hexadecimal code of the folder color."
},
"folder_uri": {
"type": "string",
"example": "/users/112233/projects/12345",
"nullable": true,
"description": "The URI of the folder."
}
},
"description": "The settings of the folder."
},
"is_pinned": {
"type": "boolean",
"example": true,
"description": "Whether the folder is pinned."
},
"pinned_on": {
"type": "string",
"example": "2017-05-23T14:36:22+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the folder was pinned."
},
"creator_uri": {
"type": "string",
"example": "/users/112233",
"description": "The URI for the user who created the folder."
},
"manage_link": {
"type": "string",
"example": "https://vimeo.com/user/112233/folder/12345",
"description": "The link to the folder management page."
},
"access_grant": {
"type": "object",
"description": "The access grant response that applies to the team member. _This field is deprecated because grants are no longer exposed via API responses._"
},
"created_time": {
"type": "string",
"example": "2017-05-23T14:36:22+00:00",
"description": "The time in ISO 8601 format when the folder was created."
},
"resource_key": {
"type": "string",
"example": "dc724af18fbdd4e59189f5fe768a5f8311527050",
"description": "The resource key string of the folder."
},
"has_subfolder": {
"type": "boolean",
"example": true,
"description": "Whether this folder has at least one subfolder."
},
"modified_time": {
"type": "string",
"example": "2017-05-23T14:36:22+00:00",
"description": "The time in ISO 8601 format when the folder was last modified."
},
"is_private_to_user": {
"type": "boolean",
"example": true,
"description": "Whether the folder is a private-to-me folder for the user."
},
"last_user_action_event_date": {
"type": "string",
"example": "2018-03-21T23:08:22+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when a user last performed an action on the folder."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the folder."
}
}
}
project-item
{
"type": "object",
"title": "Project Item",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"folder",
"live_event",
"video"
],
"type": "string",
"example": "folder",
"description": "The project item type.\n\nOption descriptions:\n * `folder` - The project item is a folder.\n * `live_event` - The project item is a live event.\n * `video` - The project item is a video.\n"
},
"video": {
"$ref": "#/components/schemas/video"
},
"folder": {
"$ref": "#/components/schemas/project"
},
"live_event": {
"$ref": "#/components/schemas/live-event-recurring"
}
},
"x-konfig-properties": {
"video": {
"description": "The project item video."
},
"folder": {
"description": "The project item folder."
},
"live_event": {
"description": "The project item live event."
}
}
}
purchase-interaction
{
"type": "object",
"title": "Purchase Interaction",
"properties": {
"buy": {
"type": "object",
"nullable": true,
"description": "Information on purchasing the On Demand video."
},
"rent": {
"type": "object",
"nullable": true,
"description": "Information on renting the On Demand video."
},
"subscribe": {
"type": "object",
"nullable": true,
"properties": {
"drm": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand subscription has DRM."
},
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/products/12345",
"nullable": true,
"description": "The On Demand subscription's product URI."
},
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever",
"nullable": true,
"description": "The URL to purchase the On Demand subscription on Vimeo."
},
"stream": {
"enum": [
"available",
"purchased",
"restricted",
"unavailable"
],
"type": "string",
"example": "available",
"description": "The user's streaming access to the On Demand subscription.\n\nOption descriptions:\n * `available` - The On Demand subscription is available for streaming.\n * `purchased` - The On Demand subscription has been purchased.\n * `restricted` - Streaming for the On Demand subscription is restricted.\n * `unavailable` - The On Demand subscription is unavailable.\n"
},
"expires_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the On Demand video expires."
},
"purchase_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the On Demand video was purchased."
}
},
"description": "Information on subscribing to the On Demand video."
}
}
}
recurring-live-event-low-latency
{
"type": "object",
"title": "Recurring Live Event Low Latency",
"required": [
"lowLatency"
],
"properties": {
"lowLatency": {
"type": "boolean",
"example": false,
"description": "Whether the low-latency option is enabled."
}
}
}
reply
{
"type": "object",
"title": "Reply",
"required": [
"created_on",
"link",
"metadata",
"resource_key",
"text",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/comments/12345/replies/7890",
"description": "The unique identifier to access the reply resource."
},
"link": {
"type": "string",
"example": "https://vimeo.com/258684937#comment_12345",
"description": "The permalink to the reply."
},
"text": {
"type": "string",
"example": "I love this!",
"description": "The content of the reply."
},
"type": {
"enum": [
"video"
],
"type": "string",
"example": "video",
"description": "The Vimeo content to which the reply relates.\n\nOption descriptions:\n * `video` - The comment is about a video.\n"
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"user"
],
"properties": {
"user": {
"type": "object",
"required": [
"link",
"name",
"pictures",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The unique identifier to access the user resource."
},
"link": {
"type": "string",
"description": "The absolute URL of the authenticated users's profile page."
},
"name": {
"type": "string",
"description": "The display name of the user who posted the reply."
},
"pictures": {
"$ref": "#/components/schemas/picture"
}
},
"description": "Information about the user who posted the reply.",
"x-konfig-properties": {
"pictures": {
"description": "Information about the user's portraits."
}
}
}
}
}
}
},
"created_on": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the reply was posted."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The comment's resource key string."
}
}
}
segment
{
"type": "object",
"title": "Segment",
"required": [
"autogenerated",
"cue_end",
"cue_start",
"enabled",
"id",
"kind",
"language",
"lines",
"speaker",
"text_track_uri",
"words"
],
"properties": {
"id": {
"type": "string",
"example": "9854acd6-9c48-4244-9851-162dd52e9d74#25409003#101800",
"description": "The segment identifier."
},
"kind": {
"enum": [
"captions",
"subtitles"
],
"type": "string",
"example": "captions",
"description": "The type of caption that the segment originates from.\n\nOption descriptions:\n * `captions` - The segment originates from a captions file.\n * `subtitles` - The segment originates from a captions and subtitles file.\n"
},
"lines": {
"type": "array",
"items": {
"$ref": "#/components/schemas/segment-line"
},
"description": "The line data for the segment."
},
"words": {
"type": "array",
"items": {
"$ref": "#/components/schemas/segment-words"
},
"description": "The word data for the segment."
},
"cue_end": {
"type": "number",
"example": 103200,
"description": "The cue end timestamp in milliseconds from the start of the video."
},
"enabled": {
"type": "boolean",
"example": false,
"description": "Whether the segment is enabled."
},
"speaker": {
"type": "string",
"example": "1",
"description": "The speaker identifier."
},
"language": {
"type": "string",
"example": "en-x-autogenerated",
"description": "The language of the segment."
},
"cue_start": {
"type": "number",
"example": 101800,
"description": "The cue start timestamp in milliseconds from the start of the video."
},
"video_uri": {
"type": "string",
"example": "/videos/668723010",
"description": "The canonical relative URI of the segment's video."
},
"autogenerated": {
"type": "boolean",
"example": true,
"description": "Whether the segment is autogenerated."
},
"text_track_uri": {
"type": "string",
"example": "/videos/668723010/texttracks/12345",
"description": "The relative URI of the text track that the segment comes from."
}
}
}
segment-line
{
"type": "object",
"title": "Segment Line",
"required": [
"text",
"voice"
],
"properties": {
"text": {
"type": "string",
"example": "Hello World!",
"description": "The text from the segment line."
},
"voice": {
"type": "string",
"nullable": true,
"description": "The speaker of the segment line."
}
}
}
segment-words
{
"type": "object",
"title": "Segment Words",
"required": [
"end_time",
"start_time",
"word"
],
"properties": {
"word": {
"type": "string",
"description": "The word text."
},
"end_time": {
"type": "number",
"nullable": true,
"description": "The end time of the word in milliseconds."
},
"start_time": {
"type": "number",
"nullable": true,
"description": "The start time of the word in milliseconds."
}
}
}
skill
{
"type": "object",
"title": "Skill",
"required": [
"name",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/marketplace/skills/152184",
"description": "The skill's canonical relative URI."
},
"name": {
"type": "string",
"example": "Director",
"description": "The skill's display name."
}
}
}
subscription
{
"type": "object",
"title": "Subscription",
"required": [
"account_id",
"auto_renew",
"created_at",
"end_date",
"id",
"is_latest",
"payment_method_id",
"plans",
"start_date",
"status",
"subscription_number",
"subscription_version",
"updated_at",
"vendor"
],
"properties": {
"id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the subscription."
},
"plans": {
"type": "array",
"items": {
"type": "object",
"required": [
"created_at",
"id",
"items",
"plan_id",
"product_id",
"subscription_plan_id",
"subscription_plan_number",
"subscription_plan_type",
"synced_at",
"updated_at"
],
"properties": {
"id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the plan."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount",
"created_at",
"id",
"price_id",
"quantity",
"subscription_item_id",
"subscription_item_number",
"subscription_plan_id",
"synced_at",
"updated_at"
],
"properties": {
"id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the item."
},
"amount": {
"type": "number",
"items": {
"unit": {
"type": "number",
"example": 1200,
"required": true,
"description": "The money amount in the lowest denomination. For instance, for USD, the lowest denomination is cents, so $12 is represented as 1200."
},
"amount": {
"type": "number",
"example": 12,
"required": false,
"description": "The amount in actual currency."
},
"currency": {
"type": "string",
"example": "USD",
"required": false,
"description": "The currency of the amount."
},
"formatted": {
"type": "string",
"example": "12.00",
"required": false,
"description": "The formatted amount."
}
},
"example": 1,
"description": "The amount of the item."
},
"end_date": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the item ended."
},
"metadata": {
"type": "object",
"description": "The metadata of the item."
},
"price_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the price."
},
"quantity": {
"type": "number",
"example": 1,
"description": "The quantity of the item."
},
"synced_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the item was synced."
},
"created_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the item was created."
},
"start_date": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the item started."
},
"updated_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the item was updated."
},
"subscription_item_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the subscription item."
},
"subscription_plan_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the subscription plan."
},
"subscription_item_number": {
"type": "string",
"example": "12345",
"description": "The number of the subscription item."
}
}
},
"description": "An array of items in the plan."
},
"amount": {
"$ref": "#/components/schemas/money"
},
"plan_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the plan."
},
"metadata": {
"type": "object",
"description": "The metadata of the plan."
},
"quantity": {
"type": "number",
"example": 1,
"description": "The quantity of the plan."
},
"synced_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the plan was synced."
},
"created_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the plan was created."
},
"product_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the product."
},
"promo_code": {
"type": "string",
"example": "abc12345",
"description": "The promotional code."
},
"updated_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in 8601 format when the plan was updated."
},
"promo_code_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the promotional code."
},
"billing_plan_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the billing plan."
},
"billing_plan_type": {
"type": "string",
"example": "abc12345",
"description": "The type of the billing plan."
},
"subscription_plan_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the subscription plan."
},
"subscription_plan_type": {
"type": "string",
"example": "abc12345",
"description": "The type of the subscription plan."
},
"billing_plan_product_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the billing plan product."
},
"subscription_plan_number": {
"type": "string",
"example": "12345",
"description": "The number of the subscription plan."
}
},
"x-konfig-properties": {
"amount": {
"example": "1.00",
"description": "The amount of the plan."
}
}
},
"description": "An array of plans in the subscription."
},
"status": {
"enum": [
"SUBSCRIPTION_STATUS_ACTIVE",
"SUBSCRIPTION_STATUS_CANCELLED",
"SUBSCRIPTION_STATUS_GRACE_PERIOD",
"SUBSCRIPTION_STATUS_IN_TRIAL",
"SUBSCRIPTION_STATUS_PAST_DUE",
"SUBSCRIPTION_STATUS_UNPAID",
"SUBSCRIPTION_STATUS_UNSPECIFIED"
],
"type": "string",
"example": "SUBSCRIPTION_STATUS_ACTIVE",
"description": "The status of the subscription.\n\nOption descriptions:\n * `SUBSCRIPTION_STATUS_ACTIVE` - The subscription is active.\n * `SUBSCRIPTION_STATUS_CANCELLED` - The subscription is canceled.\n * `SUBSCRIPTION_STATUS_GRACE_PERIOD` - The subscription is in a grace period.\n * `SUBSCRIPTION_STATUS_IN_TRIAL` - The subscription is in a trial period.\n * `SUBSCRIPTION_STATUS_PAST_DUE` - The subscription is past due.\n * `SUBSCRIPTION_STATUS_UNPAID` - The subscription is unpaid.\n * `SUBSCRIPTION_STATUS_UNSPECIFIED` - The subscription status is unspecified.\n"
},
"vendor": {
"type": "string",
"example": "vimeo",
"description": "The vendor of the subscription."
},
"end_date": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in ISO 8601 format when the subscription ended."
},
"is_latest": {
"type": "boolean",
"example": true,
"description": "Whether the subscription is the latest version."
},
"account_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the account."
},
"auto_renew": {
"type": "boolean",
"example": true,
"description": "Whether the subscription is set to auto-renew."
},
"created_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in ISO 8601 format when the subscription was created."
},
"start_date": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in ISO 8601 format when the subscription started."
},
"updated_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in ISO 8601 format when the subscription was updated."
},
"disabled_at": {
"type": "string",
"example": "2020-01-01T00:00:00Z",
"description": "The time in ISO 8601 format when the subscription was disabled."
},
"grace_period_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the grace period."
},
"payment_method_id": {
"type": "string",
"example": "abc12345",
"description": "The ID of the payment method."
},
"subscription_number": {
"type": "string",
"example": "12345",
"description": "The number of the subscription."
},
"subscription_version": {
"type": "number",
"example": 1,
"description": "The version of the subscription."
}
}
}
subscription-plans
{
"type": "object",
"title": "Subscription Plans",
"required": [
"currency",
"discount",
"id",
"metadata",
"name",
"price",
"promotion",
"tier",
"uri"
],
"properties": {
"id": {
"type": "number",
"example": 12341,
"description": "The SKU of the plan."
},
"uri": {
"type": "string",
"example": "/plans/pro",
"description": "The URI of the plan."
},
"name": {
"type": "string",
"example": "Pro",
"description": "The name of the plan."
},
"tier": {
"enum": [
"advanced",
"basic",
"business",
"enterprise",
"free",
"livePremium",
"ott",
"plus",
"pro",
"proUnlimited",
"standard",
"starter"
],
"type": "string",
"example": "pro",
"description": "The plan type.\n\nOption descriptions:\n * `advanced` - The plan type is Vimeo Advanced.\n * `basic` - The plan type is Vimeo Basic.\n * `business` - The plan type is Vimeo Business.\n * `enterprise` - The plan type is Vimeo Enterprise.\n * `free` - The plan type is Vimeo Free.\n * `livePremium` - The plan type is Vimeo Premium.\n * `ott` - The plan type is Vimeo OTT.\n * `plus` - The plan type is Vimeo Plus.\n * `pro` - The plan type is Vimeo Pro.\n * `proUnlimited` - The plan type is Vimeo Pro Unlimited.\n * `standard` - The plan type is Vimeo Standard.\n * `starter` - The plan type is Vimeo Starter.\n"
},
"price": {
"type": "object",
"required": [
"annual",
"annual_monthly"
],
"properties": {
"annual": {
"type": "number",
"description": "The annual price, charged annually."
},
"monthly": {
"type": "number",
"description": "The monthly price, charged monthly."
},
"annual_monthly": {
"type": "number",
"description": "The monthly price, charged annually."
}
},
"description": "Information about the prices associated with the plan."
},
"currency": {
"type": "object",
"required": [
"currency_code",
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"example": "$",
"description": "The symbol of the associated currency."
},
"currency_code": {
"type": "string",
"example": "USD",
"description": "The ISO code of the associated currency."
}
},
"description": "Information about the currency in which the price of the plan is expressed."
},
"discount": {
"type": "object",
"required": [
"annual"
],
"properties": {
"annual": {
"type": "number",
"description": "The annual discount."
}
},
"description": "Information about the plan discount."
},
"metadata": {
"type": "object",
"required": [
"entitlements",
"interactions",
"purchased_product",
"video_quota"
],
"properties": {
"video_quota": {
"type": "object",
"required": [
"lifetime",
"monthly",
"yearly"
],
"properties": {
"yearly": {
"type": "number",
"description": "The yearly video upload quota associated with the product."
},
"monthly": {
"type": "number",
"description": "The monthly video upload quota associated with the product."
},
"lifetime": {
"type": "number",
"nullable": true,
"description": "The total video upload quota associated with the product."
}
},
"description": "The video upload quotas associated with the product."
},
"entitlements": {
"type": "object",
"required": [
"params"
],
"properties": {
"params": {
"type": "object",
"required": [
"team_seats",
"video_storage_periodic_quota",
"video_storage_quota_cap",
"video_storage_quota_period",
"video_storage_quota_unit"
],
"properties": {
"team_seats": {
"type": "string",
"nullable": true,
"description": "The number of team seats included with the tier."
},
"video_storage_quota_cap": {
"type": "string",
"nullable": true,
"description": "The video storage total lifetime cap."
},
"video_storage_quota_unit": {
"enum": [
"video_count",
"video_size"
],
"type": "string",
"example": "video_count",
"description": "The unit of the video storage for the user's periodic quota.\n\nOption descriptions:\n * `video_count` - The product has video storage based on video count.\n * `video_size` - The product has video storage based on video size.\n"
},
"video_storage_quota_period": {
"enum": [
"lifetime",
"month",
"week",
"year"
],
"type": "string",
"example": "lifetime",
"description": "The video storage quota period.\n\nOption descriptions:\n * `lifetime` - The product has a lifetime video storage quota period.\n * `month` - The product has a monthly video storage quota period.\n * `week` - The product has a weekly video storage quota period.\n * `year` - The product has a yearly video storage quota period.\n"
},
"video_storage_periodic_quota": {
"type": "string",
"nullable": true,
"description": "The amount of video storage for the user's periodic quota."
}
},
"description": "The list of entitlement parameters corresponding to the tier."
}
},
"description": "A list that contains all entitlement data corresponding to the tier."
},
"interactions": {
"type": "object",
"required": [
"purchase"
],
"properties": {
"purchase": {
"type": "object",
"required": [
"status",
"uri"
],
"properties": {
"uri": {
"type": "object",
"required": [
"annual",
"free_trial",
"monthly"
],
"properties": {
"annual": {
"type": "string",
"nullable": true,
"description": "The redirect URI for the annual plan in the user's cart."
},
"monthly": {
"type": "string",
"nullable": true,
"description": "The redirect URI for the monthly plan in the user's cart."
},
"free_trial": {
"type": "string",
"nullable": true,
"description": "The redirect URI for the free trial in the user's cart."
}
},
"description": "The redirect URIs associated with the plan."
},
"status": {
"enum": [
"available",
"purchased",
"unavailable"
],
"type": "string",
"example": "available",
"description": "The purchase status of the product.\n\nOption descriptions:\n * `available` - The product is available for purchase.\n * `purchased` - The product is already purchased.\n * `unavailable` - The product isn't available for purchase.\n"
}
}
}
}
},
"purchased_product": {
"type": "object",
"required": [
"display_price",
"is_monthly"
],
"properties": {
"is_monthly": {
"type": "boolean",
"description": "Whether the purchased product is billed as a monthly subscription."
},
"display_price": {
"type": "number",
"description": "The display price of the purchased product."
}
},
"description": "Information about the purchased product."
}
},
"description": "The URLs and entitlements of the associated products in the store."
},
"promotion": {
"type": "object",
"required": [
"code",
"discount",
"price",
"uri"
],
"properties": {
"uri": {
"type": "object",
"properties": {
"annual": {
"type": "string",
"description": "The URI of the annual promotion."
},
"monthly": {
"type": "string",
"description": "The URI of the monthly promotion."
}
},
"description": "Information about the URIs associated with the promotion."
},
"code": {
"type": "string",
"description": "The promotion code."
},
"price": {
"type": "object",
"properties": {
"annual": {
"type": "number",
"description": "The promotional annual price, charged annually."
},
"monthly": {
"type": "number",
"description": "The promotional monthly price, charged monthly."
},
"annual_monthly": {
"type": "number",
"description": "The promotional monthly price, charged annually."
}
},
"description": "The price map of the promotion."
},
"discount": {
"type": "number",
"description": "The promotion discount percentage."
}
},
"description": "Information about the plan's promotion."
}
}
}
tag
{
"type": "object",
"title": "Tag",
"required": [
"canonical",
"metadata",
"name",
"resource_key",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/tags/awesome",
"description": "The canonical relative URI of the tag."
},
"name": {
"type": "string",
"example": "awesome",
"description": "The tag value."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/tags/awesome/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 34371,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos related to this tag."
}
},
"description": "A collection of information that is connected to this resource."
}
},
"description": "Metadata about the tag."
},
"canonical": {
"type": "string",
"example": "awesome",
"description": "The normalized canonical tag name."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The tag's resource key string."
}
}
}
team-membership
{
"type": "object",
"title": "Team Membership",
"required": [
"access_grant",
"active",
"applicable_permission_policies",
"applicable_roles",
"created_time",
"email",
"invite_url",
"joined_time",
"metadata",
"modified_time",
"permission_level",
"resource_key",
"role",
"status",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/team_users/12345",
"description": "The unique identifier to access the team membership resource."
},
"role": {
"type": "string",
"description": "The team member's role, translated."
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The team member. The value of this field is null if the user hasn't joined the team yet."
},
"email": {
"type": "string",
"example": "user@example.com",
"description": "The team member's email."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the team membership is currently active."
},
"status": {
"enum": [
"accepted",
"pending"
],
"type": "string",
"example": "accepted",
"description": "The status of the team membership invite.\n\nOption descriptions:\n * `accepted` - Team membership has been accepted.\n * `pending` - Team membership has been offered but not yet accepted.\n"
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"owner",
"personal_team_folder"
],
"properties": {
"owner": {
"type": "object",
"required": [
"display_name",
"email",
"invites_remaining",
"options",
"total",
"total_members",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184",
"description": "The API URI that resolves to the connection data."
},
"email": {
"type": "string",
"example": "user@example.com",
"description": "The team owner's email address."
},
"total": {
"type": "number",
"example": 1,
"description": "The total number of owners on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"display_name": {
"type": "string",
"example": "Example Team Name",
"description": "The display name of the team owner."
},
"total_members": {
"type": "number",
"example": 3,
"description": "The total number of team members for the specified team owner."
},
"invites_remaining": {
"type": "number",
"example": 5,
"description": "The total number of remaining team member invites."
}
},
"description": "A standard connection object indicating how to get the owner of this user."
},
"personal_team_folder": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/178786123/projects/1129133",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12,
"description": "The total number of personal team folders on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "A standard connection object indicating how to return personal team folders."
}
},
"description": "A list of resource URIs related to the user."
}
},
"description": "The metadata of the team membership."
},
"invite_url": {
"type": "string",
"example": "https://vimeo.com/user/seat?code=e7c71ae7f4dc5d71a3bceb4d1d9e",
"nullable": true,
"description": "The URL for the invited user to join the team. The value of this field is null if the invited user has already joined."
},
"joined_time": {
"type": "string",
"example": "2017-05-15T17:42:07+00:00",
"description": "The time in ISO 8601 format when the invite was accepted."
},
"access_grant": {
"type": "object",
"nullable": true,
"description": "Information about an access grant that applies to the team member on the folder. _This field is deprecated because grants are no longer exposed via API responses._"
},
"created_time": {
"type": "string",
"example": "2017-05-15T17:42:07+00:00",
"description": "The time in ISO 8601 format when the invite was sent."
},
"resource_key": {
"type": "string",
"example": "dc724af18fbdd4e59189f5fe768a5f8311527050",
"description": "The resource key of the team membership."
},
"modified_time": {
"type": "string",
"example": "2017-05-15T17:42:07+00:00",
"description": "The time in ISO 8601 format when the team membership was last modified."
},
"applicable_roles": {
"type": "array",
"items": {
"$ref": "#/components/schemas/team-role"
},
"description": "An array of the team roles this team member can have."
},
"permission_level": {
"enum": [
"Admin",
"Contributor",
"Contributor Plus",
"Owner",
"Uploader",
"Viewer"
],
"type": "string",
"example": "Admin",
"description": "The team member's permission level.\n\nOption descriptions:\n * `Admin` - The team member has admin permissions. They can upload and edit videos for the entire team and perform team administration tasks.\n * `Contributor` - The team member has contributor permissions. They can upload and edit videos for the entire team but can't perform team administration tasks.\n * `Contributor Plus` - The team member has contributor plus permissions. They can upload and edit videos for the entire team, and have additional sets of permissions, but can't perform team administration tasks.\n * `Owner` - The team member has owner permissions.\n * `Uploader` - The team member has uploader permissions. They can upload videos for the entire team but can't edit videos.\n * `Viewer` - The team member has viewer permissions. They can access team videos and specific team folders but can't upload or edit videos.\n"
},
"has_folder_access": {
"type": "boolean",
"example": true,
"description": "Whether the team member has folder access."
},
"recently_reminded": {
"type": "boolean",
"example": true,
"description": "Whether the team member has been reminded about the invite."
},
"applicable_permission_policies": {
"type": "object",
"required": [
"folder",
"regional_delivery",
"video"
],
"properties": {
"video": {
"type": "array",
"items": {
"$ref": "#/components/schemas/permission-policy"
},
"description": "An array of video permission policies that can apply to the team member."
},
"folder": {
"type": "array",
"items": {
"$ref": "#/components/schemas/permission-policy"
},
"description": "An array of folder permission policies that can apply to the team member."
},
"regional_delivery": {
"type": "array",
"items": {
"$ref": "#/components/schemas/permission-policy"
},
"description": "An array of regional delivery permission policies that can apply to the team member."
}
},
"description": "Information about permission policies that can apply to the team member."
}
}
}
team-role
{
"type": "object",
"title": "Team Role",
"required": [
"permission_level",
"role",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/team/role",
"description": "The unique identifier to access the team role."
},
"role": {
"enum": [
"Admin",
"Contributor",
"Contributor Plus",
"Owner",
"Uploader",
"Viewer"
],
"type": "string",
"example": "Admin",
"nullable": true,
"description": "The untranslated role of the user who made the request.\n\nOption descriptions:\n * `Admin` - The team member has admin permissions. They can upload and edit videos for the entire team and perform team administration tasks.\n * `Contributor` - The team member has contributor permissions. They can upload and edit videos for the entire team but can’t perform team administration tasks.\n * `Contributor Plus` - The team member has contributor-plus permissions. They can upload and edit videos for the entire team and have additional sets of permissions but can't perform team administration tasks.\n * `Owner` - The team member has owner permissions.\n * `Uploader` - The team member has uploader permissions. They can upload videos for the entire team but can’t edit videos.\n * `Viewer` - The team member has viewer permissions. They can access team videos and specific team folders but can’t upload or edit videos.\n"
},
"count": {
"type": "number",
"example": 3,
"description": "The total number of team members with this role."
},
"is_disabled": {
"type": "boolean",
"example": false,
"description": "Whether the role is disabled for certain team members."
},
"display_name": {
"type": "string",
"example": "Admin",
"description": "The translated display name of the role."
},
"permission_level": {
"enum": [
"Admin",
"Contributor",
"Contributor Plus",
"Owner",
"Uploader",
"Viewer"
],
"type": "string",
"example": "Admin",
"nullable": true,
"description": "The untranslated role of the user who made the request.\n\nOption descriptions:\n * `Admin` - The team member has admin permissions. They can upload and edit videos for the entire team and perform team administration tasks.\n * `Contributor` - The team member has contributor permissions. They can upload and edit videos for the entire team but can’t perform team administration tasks.\n * `Contributor Plus` - The team member has contributor-plus permissions. They can upload and edit videos for the entire team and have additional sets of permissions but can't perform team administration tasks.\n * `Owner` - The team member has owner permissions.\n * `Uploader` - The team member has uploader permissions. They can upload videos for the entire team but can't edit videos.\n * `Viewer` - The team member has viewer permissions. They can access team videos and specific team folders but can't upload or edit videos.\n"
},
"display_description": {
"type": "string",
"example": "Can view and manage all videos, folders, people, and analytics on the account.",
"description": "The translated display description of the role."
},
"applicable_permission_policies": {
"type": "object",
"properties": {
"video": {
"type": "array",
"items": {
"type": "string"
},
"description": "The applicable video-related permission policies for the role."
},
"folder": {
"type": "array",
"items": {
"type": "string"
},
"description": "The applicable folder-related permission policies for the role."
},
"regional_delivery": {
"type": "array",
"items": {
"type": "object",
"required": [
"display_description",
"display_name",
"name"
],
"properties": {
"name": {
"type": "string",
"example": "regional_delivery",
"description": "The name of the regional delivery permission policy."
},
"display_name": {
"type": "string",
"example": "Regional delivery",
"description": "The translated display name of the regional delivery permission policy."
},
"display_description": {
"type": "string",
"example": "This policy allows the user to restrict the delivery of videos to specific regions.",
"description": "The translated display description of the regional delivery permission policy."
}
}
},
"description": "The applicable permission policies related to regional delivery for the role."
}
},
"description": "The applicable permission policies for the role."
}
}
}
text-track
{
"type": "object",
"title": "Text Track",
"required": [
"active",
"display_language",
"hls_link",
"hls_link_expires_time",
"id",
"language",
"link",
"link_expires_time",
"name",
"type",
"uri"
],
"properties": {
"id": {
"type": "number",
"example": 12345,
"description": "The text track identifier."
},
"uri": {
"type": "string",
"example": "/videos/258684937/texttracks/12345",
"description": "The relative URI of the text track."
},
"link": {
"type": "string",
"description": "The read-only URL of the text track file. You can upload to this link when you create it for the first time."
},
"name": {
"type": "string",
"example": "English Subtitles",
"nullable": true,
"description": "The descriptive name of the text track."
},
"type": {
"enum": [
"captions",
"subtitles"
],
"type": "string",
"example": "captions",
"nullable": true,
"description": "The type of text track.\n\nOption descriptions:\n * `captions` - The text track is for captions.\n * `subtitles` - The text track is for subtitles.\n"
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the text track is active."
},
"hls_link": {
"type": "string",
"description": "The read-only URL of the text track file, intended for use with HLS playback."
},
"language": {
"type": "string",
"example": "en-US",
"nullable": true,
"description": "The language code for the text track. To see a full list, request `/languages?filter=texttrack`."
},
"display_language": {
"type": "string",
"example": "English (United States)",
"description": "The name of the language."
},
"link_expires_time": {
"type": "string",
"example": "1494888499",
"description": "The time in ISO 8601 format when the text track link expires."
},
"hls_link_expires_time": {
"type": "string",
"example": "1494888499",
"description": "The time in ISO 8601 format when the read-only HLS playback text track file expires."
}
}
}
trimmed-video
{
"type": "object",
"title": "Trimmed Video",
"required": [
"clip_id",
"created_on",
"created_version_id",
"end",
"is_clip_finished_transcoding",
"metadata",
"modified_on",
"root_version_id",
"start",
"uri",
"version_quality"
],
"properties": {
"end": {
"type": "string",
"example": "5.0",
"description": "The end of the trim from the last trim, in seconds."
},
"uri": {
"type": "string",
"example": "https://player.vimeo.com/video/1234",
"description": "The URI of the player or the trim service. _This field is deprecated._"
},
"start": {
"type": "string",
"example": "1.0",
"description": "The start of the trim from the last trim, in seconds."
},
"clip_id": {
"type": "number",
"example": 258684937,
"description": "The ID of the video. _This field is deprecated._"
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"created_version",
"root_version",
"video"
],
"properties": {
"video": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/3706071",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video associated with the trim."
},
"root_version": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/1234/versions/2345",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video version that is the source of the trimmed video."
},
"created_version": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/1234/versions/2345",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video version that is created from the trim operation."
}
}
}
}
},
"created_on": {
"type": "string",
"description": "The time in ISO 8601 format when the trim was created."
},
"modified_on": {
"type": "string",
"nullable": true,
"description": "The time in ISO 8601 format when the trim policy was last modified."
},
"root_version_id": {
"type": "string",
"example": "12354",
"description": "The video version that is the source of the trimmed video. _This field is deprecated._"
},
"version_quality": {
"type": "string",
"example": "5",
"description": "The quality of the root version video file."
},
"created_version_id": {
"type": "string",
"example": "12354",
"description": "The most recent version of the trimmed video. _This field is deprecated._"
},
"is_clip_finished_transcoding": {
"type": "boolean",
"example": true,
"description": "Whether the transcoding jobs for the video file have finished. _This field is deprecated._"
}
}
}
tutorial
{
"type": "object",
"title": "Tutorial",
"required": [
"message",
"next_steps_link",
"token_is_authenticated"
],
"properties": {
"message": {
"type": "string",
"example": "Success!",
"description": "The success message."
},
"next_steps_link": {
"type": "string",
"example": "https://developer.vimeo.com/api/guides/videos/upload",
"description": "The link to the next tutorial."
},
"token_is_authenticated": {
"type": "boolean",
"example": true,
"description": "Whether the current access token is authenticated."
}
}
}
upload-attempt
{
"type": "object",
"title": "Upload Attempt",
"required": [
"ticket_id",
"upload_link",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/uploads/12345",
"description": "The upload URI."
},
"clip": {
"$ref": "#/components/schemas/video"
},
"form": {
"type": "string",
"description": "The HTML upload form."
},
"user": {
"$ref": "#/components/schemas/user"
},
"ticket_id": {
"type": "string",
"example": "3da5dac09",
"description": "The ticket identifier string for the upload."
},
"upload_link": {
"type": "string",
"example": "https://123456.cloud.vimeo.com/upload?ticket_id=1234asdf",
"description": "The upload URL."
}
},
"x-konfig-properties": {
"clip": {
"description": "The video to upload."
},
"user": {
"description": "The owner of the uploaded video."
}
}
}
user
{
"type": "object",
"title": "User",
"required": [
"account",
"available_for_hire",
"can_work_remotely",
"capabilities",
"clients",
"created_time",
"is_expert",
"link",
"metadata",
"name",
"pictures",
"preferences",
"resource_key",
"upload_quota",
"uri",
"websites"
],
"properties": {
"bio": {
"type": "string",
"example": "This is where you will find videos and news updates from the staff.",
"description": "The authenticated user's long biography text."
},
"uri": {
"type": "string",
"example": "/users/152184",
"description": "The authenticated user's canonical relative URI."
},
"link": {
"type": "string",
"example": "https://vimeo.com/staff",
"description": "The absolute URL of the authenticated users's profile page."
},
"name": {
"type": "string",
"example": "Vimeo Staff",
"description": "The authenticated user's display name."
},
"gender": {
"type": "string",
"example": "m",
"description": "The authenticated user's gender."
},
"skills": {
"type": "array",
"items": {
"$ref": "#/components/schemas/skill"
},
"description": "A list of the authenticated user's skills."
},
"account": {
"enum": [
"advanced",
"basic",
"business",
"enterprise",
"free",
"live_business",
"live_premium",
"live_pro",
"plus",
"pro",
"pro_unlimited",
"producer",
"standard",
"starter"
],
"type": "string",
"example": "advanced",
"description": "The authenticated user's account type.\n\nOption descriptions:\n * `advanced` - The user has a Vimeo Advanced subscription.\n * `basic` - The user has a Vimeo Basic subscription.\n * `business` - The user has a Vimeo Business subscription.\n * `enterprise` - The user has a Vimeo Enterprise subscription.\n * `free` - The user has a Vimeo Free subscription.\n * `live_business` - The user has a Vimeo Business Live subscription.\n * `live_premium` - The user has a Vimeo Premium subscription.\n * `live_pro` - The user has a Vimeo PRO Live subscription.\n * `plus` - The user has a Vimeo Plus subscription.\n * `pro` - The user has a Vimeo Pro subscription.\n * `pro_unlimited` - The user has a Vimeo PRO Unlimited subscription.\n * `producer` - The user has a Vimeo Producer subscription.\n * `standard` - The user has a Vimeo Standard subscription.\n * `starter` - The user has a Vimeo Starter subscription.\n"
},
"clients": {
"type": "string",
"example": "vimeo",
"description": "The comma-separated list of clients."
},
"location": {
"type": "string",
"example": "New York City",
"description": "The authenticated user's location."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions",
"public_videos"
],
"properties": {
"connections": {
"type": "object",
"required": [
"albums",
"appearances",
"categories",
"channels",
"feed",
"folders_root",
"followers",
"following",
"groups",
"likes",
"moderated_channels",
"pictures",
"portfolios",
"shared",
"videos",
"watchlater"
],
"properties": {
"feed": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/feed",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's feed."
},
"block": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/block",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 73,
"description": "The total number of blocked users on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the users that the authenticated user has blocked. This data requires a bearer token with the `private` scope. This data requires a bearer token with the `private` scope."
},
"likes": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/likes",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 300,
"description": "The total number of likes on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that the authenticated user has liked."
},
"albums": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/albums",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 3,
"description": "The total number of showcases on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the showcases created by the authenticated user."
},
"groups": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/groups",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 2,
"description": "The total number of groups on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the groups created by the authenticated user."
},
"shared": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/shared/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 15,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that have been shared with the authenticated user."
},
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 36,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that the authenticated user has uploaded."
},
"folders": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/folders",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 9,
"description": "The total number of folders on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's folders."
},
"channels": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/channels",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of channels on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the channels to which the authenticated user subscribes."
},
"pictures": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/pictures",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 3,
"description": "The total number of pictures on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's portraits."
},
"followers": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/followers",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 12,
"description": "The total number of followers on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's followers."
},
"following": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/following",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 47,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the users that the authenticated user is following."
},
"categories": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/categories",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 5,
"description": "The total number of categories on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the categories that the authenticated user is following."
},
"portfolios": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/portfolios",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 5,
"description": "The total number of portfolios on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's portfolios."
},
"watchlater": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/watchlater",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 14,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that the authenticated user has marked to watch later."
},
"appearances": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/appearances",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of appearances on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the appearances of the authenticated user in other videos."
},
"folders_root": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456789/folders/root",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's root level folders and videos."
},
"connected_apps": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/connected_apps",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of connected apps on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the authenticated user's connected apps."
},
"watched_videos": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/watched/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 322,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that the authenticated user has watched."
},
"recommended_users": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/recommendations/users",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of users on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "A collection of recommended users for the authenticated user to follow. This data requires a bearer token with the `private` scope. This data requires a bearer token with the `private` scope."
},
"moderated_channels": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/channels?filter=moderated",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 1,
"description": "The total number of channels on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the channels that the authenticated user moderates."
},
"recommended_channels": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/recommendations/channels",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of channels on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "A collection of recommended channels for the authenticated user to follow. This data requires a bearer token with the `private` scope. This data requires a bearer token with the `private` scope."
}
},
"description": "The list of resource URIs related to the authenticated user."
},
"interactions": {
"type": "object",
"required": [
"block",
"report"
],
"properties": {
"block": {
"type": "object",
"required": [
"added",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/me/block/3766357",
"description": "The URI to block or unblock the requested user."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user is blocking the requested user."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
},
"added_time": {
"type": "string",
"example": "2017-05-16T15:05:43+00:00",
"description": "The time in ISO 8601 format when the block occurred, or the null value if no block exists."
}
},
"description": "Information about the block status of the authenticated user."
},
"follow": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/following/3766357",
"description": "The URI to follow the requested user."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user is following the requested user."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the followed status of the authenticated user."
},
"report": {
"type": "object",
"required": [
"options",
"reason",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/152184/report",
"description": "The API URI that resolves to the connection data."
},
"reason": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of valid reasons for reporting a video."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to report the requested user."
},
"connected_apps": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/me/connected_apps/facebook",
"description": "The URI of the connected app."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
},
"all_scopes": {
"type": "object",
"description": "The list of all the scopes on the connected app that are needed for a particular Vimeo feature."
},
"is_connected": {
"type": "boolean",
"example": true,
"description": "Whether the authenticated user is connected to the connected app."
},
"needed_scopes": {
"type": "object",
"description": "The list of the remaining scopes on the connected app that the authenticated user needs for a particular Vimeo feature."
}
}
},
"add_privacy_user": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/channels/152184/privacy/users",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
}
}
}
},
"public_videos": {
"type": "object",
"required": [
"total"
],
"properties": {
"total": {
"type": "number",
"example": 100,
"description": "The total number of public videos that the authenticated user has uploaded."
}
}
}
},
"description": "The authenticated user's metadata."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"websites": {
"type": "array",
"items": {
"type": "object",
"required": [
"link",
"type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/1234/links/1",
"description": "The URI of the custom website or social media page belonging to the user."
},
"link": {
"type": "string",
"example": "https://twitter.com/vimeo",
"description": "The URL of the website."
},
"name": {
"type": "string",
"example": "Twitter",
"description": "The name of the website."
},
"type": {
"type": "string",
"example": "facebook",
"description": "The URL type of the website."
},
"description": {
"type": "string",
"example": "Follow us on Twitter!",
"description": "The website's description."
}
}
},
"description": "The authenticated user's websites."
},
"is_expert": {
"type": "boolean",
"example": false,
"description": "Whether the creator enrolled in and successfully completed the Vimeo Experts program."
},
"short_bio": {
"type": "string",
"example": "This is a short biography about me!",
"description": "The authenticated user's short biography text."
},
"preferences": {
"type": "object",
"required": [
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"rating"
],
"properties": {
"rating": {
"enum": [
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "drugs"
},
"description": "An array of the authorized user's default content ratings.\n\nOption descriptions:\n * `drugs` - The video contains drug or alcohol use.\n * `language` - The video contains profanity or sexually suggestive content.\n * `nudity` - The video contains nudity.\n * `safe` - The video is suitable for all audiences.\n * `unrated` - The video hasn't been rated.\n * `violence` - The video contains violent or graphic content.\n"
},
"privacy": {
"type": "object",
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether other users can add the authenticated user's videos."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"unlisted",
"users"
],
"type": "string",
"example": "anybody",
"description": "The authenticated user's privacy preference for views.\n\nOption descriptions:\n * `anybody` - Anyone can view the user's videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only contacts can view the user's videos. _This field is deprecated._\n * `disable` - Views are disabled for the user's videos. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end.\n * `nobody` - No one except the user can view the user's videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can view the user's videos.\n * `unlisted` - Anybody can view the user's videos if they have a link.\n * `users` - Only other Vimeo members can view the user's videos. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The authenticated user's privacy preference for embeds.\n\nOption descriptions:\n * `private` - Only the user can embed their own videos.\n * `public` - Anyone can embed the user's videos.\n * `whitelist` - Only those on the whitelist can embed the user's videos.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"example": "anybody",
"description": "The authenticated user's privacy preference for comments.\n\nOption descriptions:\n * `anybody` - Anyone can comment on the user's videos.\n * `contacts` - Only contacts can comment on the user's videos.\n * `nobody` - No one can comment on the user's videos.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether other users can download the authenticated user's videos."
},
"password": {
"type": "string",
"example": "videopassword",
"description": "The default password for the video."
}
}
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The password for viewing the authenticated user's videos."
}
}
}
}
},
"capabilities": {
"type": "object",
"description": "The users's capabilities list."
},
"created_time": {
"type": "string",
"example": "2007-01-18T16:40:11+00:00",
"description": "The time in ISO 8601 format when the user account was created."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The authenticated user's resource key string."
},
"upload_quota": {
"type": "object",
"required": [
"lifetime",
"periodic",
"space"
],
"properties": {
"space": {
"type": "object",
"required": [
"free",
"max",
"showing",
"unit",
"used"
],
"properties": {
"max": {
"type": "number",
"example": 5368709120,
"nullable": true,
"description": "The maximum number of bytes or videos allotted to the authenticated user's upload quota."
},
"free": {
"type": "number",
"example": 5000000,
"description": "The number of bytes or videos remaining in the authenticated user's upload quota."
},
"unit": {
"enum": [
"video_count",
"video_size"
],
"type": "string",
"example": "video_count",
"nullable": true,
"description": "The unit that's used to compute quota.\n\nOption descriptions:\n * `video_count` - The quota is calculated using the count of the videos.\n * `video_size` - The quota is calculated using the byte size of the videos.\n"
},
"used": {
"type": "number",
"example": 5368704120,
"description": "The number of bytes or videos that the authenticated user has already uploaded against their quota."
},
"showing": {
"enum": [
"lifetime",
"periodic"
],
"type": "string",
"example": "lifetime",
"description": "The type of quota for the values of the **upload_quota.space** field.\n\nOption descriptions:\n * `lifetime` - The quota type is lifetime.\n * `periodic` - The quota type is periodic.\n"
}
},
"description": "Information about the authenticated user's upload space remaining for the current period."
},
"lifetime": {
"type": "object",
"required": [
"free",
"max",
"unit",
"used"
],
"properties": {
"max": {
"type": "number",
"example": 5368709120,
"nullable": true,
"description": "The total number of bytes or videos that the authenticated user can upload across the lifetime of their account."
},
"free": {
"type": "number",
"example": 5000000,
"nullable": true,
"description": "The number of bytes or videos remaining in the authenticated user's lifetime maximum."
},
"unit": {
"enum": [
"video_count",
"video_size"
],
"type": "string",
"example": "video_count",
"nullable": true,
"description": "The unit that's used to compute quota.\n\nOption descriptions:\n * `video_count` - The quota is calculated using the count of the videos.\n * `video_size` - The quota is calculated using the byte size of the videos.\n"
},
"used": {
"type": "number",
"example": 5368704120,
"nullable": true,
"description": "The number of bytes or videos that the authenticated user has already uploaded against their lifetime limit."
}
},
"description": "Information about the authenticated user's lifetime upload usage."
},
"periodic": {
"type": "object",
"required": [
"free",
"max",
"period",
"reset_date",
"unit",
"used"
],
"properties": {
"max": {
"type": "number",
"example": 5368709120,
"nullable": true,
"description": "The total number of bytes or videos that the authenticated user can upload per period."
},
"free": {
"type": "number",
"example": 5000000,
"nullable": true,
"description": "The number of bytes or video count remaining in the authenticated user's upload quota for the current period."
},
"unit": {
"enum": [
"video_count",
"video_size"
],
"type": "string",
"example": "video_count",
"nullable": true,
"description": "The unit that's used to compute quota.\n\nOption descriptions:\n * `video_count` - The quota is calculated using the count of the videos.\n * `video_size` - The quota is calculated using the byte size of the videos.\n"
},
"used": {
"type": "number",
"example": 5368704120,
"nullable": true,
"description": "The number of bytes or video count that the authenticated user has already uploaded against their quota in the current period."
},
"period": {
"enum": [
"lifetime",
"month",
"week",
"year"
],
"type": "string",
"example": "lifetime",
"nullable": true,
"description": "The renewal frequency of the quota.\n\nOption descriptions:\n * `lifetime` - The user doesn't have a periodic quota.\n * `month` - The quota renews monthly.\n * `week` - The quota renews weekly.\n * `year` - The quota renews yearly.\n"
},
"reset_date": {
"type": "string",
"example": "2029-03-13T02:35:13-04:00",
"nullable": true,
"description": "The time in ISO 8601 format when the authenticated user's upload quota resets."
}
},
"description": "Information about the authenticated user's usage for the current period."
}
},
"description": "The upload quota. This information appears only when the authenticated user has upload access and is looking at their own user record."
},
"content_filter": {
"enum": [
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "drugs"
},
"description": "The authenticated user's content filters.\n\nOption descriptions:\n * `drugs` - The content contains drug or alcohol use.\n * `language` - The content contains profanity or sexually suggestive language.\n * `nudity` - The content contains nudity.\n * `safe` - The content is suitable for all audiences.\n * `unrated` - The content hasn't been rated.\n * `violence` - The content contains violence or is graphic.\n"
},
"location_details": {
"$ref": "#/components/schemas/location"
},
"can_work_remotely": {
"type": "boolean",
"example": false,
"description": "Whether the authenticated user can work remotely."
},
"has_invalid_email": {
"type": "boolean",
"description": "Whether the user's email is invalid."
},
"available_for_hire": {
"type": "boolean",
"example": false,
"description": "Whether the authenticated user is available for hire."
}
},
"x-konfig-properties": {
"pictures": {
"description": "The active portrait of the authenticated user."
},
"location_details": {
"description": "The authenticated user's location details."
}
}
}
version-transcode-status
{
"type": "object",
"title": "Version Transcode Status",
"required": [
"is_complete",
"is_fully_playable",
"is_playable"
],
"properties": {
"is_complete": {
"type": "boolean",
"description": "Whether the video has finished transcoding."
},
"is_playable": {
"type": "boolean",
"description": "Whether the video is playable."
},
"is_fully_playable": {
"type": "boolean",
"description": "Whether the video is playable in all resolutions, up to either the source quality or 4K, whichever is lower, at standard definition."
}
}
}
video
{
"type": "object",
"title": "Video",
"required": [
"allowed_privacies",
"app",
"can_move_to_project",
"categories",
"content_rating",
"content_rating_class",
"context",
"created_time",
"custom_url",
"description",
"description_html",
"download",
"duration",
"embed",
"files",
"has_audio",
"has_audio_tracks",
"has_chapters",
"has_text_tracks",
"height",
"is_copyright_restricted",
"is_playable",
"language",
"license",
"link",
"metadata",
"modified_time",
"name",
"pictures",
"player_embed_url",
"privacy",
"rating_mod_locked",
"release_time",
"resource_key",
"show_review_page",
"show_svv_footer_banner",
"show_svv_timecoded_comments",
"spatial",
"stats",
"status",
"tags",
"transcode",
"transcript",
"type",
"upload",
"uploader",
"uri",
"user",
"version_transcode_status",
"vod",
"width"
],
"properties": {
"app": {
"$ref": "#/components/schemas/api-app"
},
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The video's canonical relative URI."
},
"vod": {
"type": "object",
"nullable": true,
"required": [
"id"
],
"properties": {
"id": {
"type": "number",
"nullable": true,
"description": "The video's Vimeo On Demand ID."
}
},
"description": "The video's Vimeo On Demand information."
},
"link": {
"type": "string",
"example": "https://vimeo.com/258684937",
"description": "The link to the video."
},
"name": {
"type": "string",
"example": "Celebrating 10 Years of Staff Picks",
"description": "The video's title."
},
"play": {
"$ref": "#/components/schemas/play"
},
"tags": {
"type": "array",
"items": {
"$ref": "#/components/schemas/tag"
},
"description": "An array of all tags assigned to the video."
},
"type": {
"enum": [
"live",
"stock",
"video"
],
"type": "string",
"example": "video",
"description": "The type of the video.\n\nOption descriptions:\n * `live` - The video is or was an event.\n * `stock` - The video is a Vimeo Stock video.\n * `video` - The video is a standard Vimeo video.\n"
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The video's owner."
},
"embed": {
"$ref": "#/components/schemas/embed-settings"
},
"files": {
"type": "array",
"items": {
"$ref": "#/components/schemas/video-file"
},
"description": "The list of files for the video. This data requires a bearer token with the `private` scope."
},
"stats": {
"type": "object",
"required": [
"plays"
],
"properties": {
"plays": {
"type": "number",
"example": 20,
"nullable": true,
"description": "The current total number of times that the video has been played."
}
},
"description": "A collection of analytics associated with the video."
},
"width": {
"type": "number",
"example": 1920,
"description": "The video's width in pixels."
},
"height": {
"type": "number",
"example": 1080,
"description": "The video's height in pixels."
},
"status": {
"enum": [
"available",
"failed",
"processing",
"quota_exceeded",
"total_cap_exceeded",
"transcode_starting",
"transcoding",
"transcoding_error",
"unavailable",
"uploading",
"uploading_error"
],
"type": "string",
"example": "available",
"nullable": true,
"description": "The status code for the availability of the video.\n\nOption descriptions:\n * `available` - The video is available.\n * `failed` - There was an error in rendering the video.\n * `processing` - Rendering has started and is currently underway for the video.\n * `quota_exceeded` - The user's weekly upload quota is exceeded with this video.\n * `total_cap_exceeded` - The user's total storage limit is exceeded with this video.\n * `transcode_starting` - Transcoding is starting for the video.\n * `transcoding` - Transcoding has started and is currently underway for the video.\n * `transcoding_error` - There was an error in transcoding the video.\n * `unavailable` - The video is unavailable.\n * `uploading` - The video is being uploaded.\n * `uploading_error` - There was an error in uploading the video.\n"
},
"upload": {
"type": "object",
"nullable": true,
"required": [
"status"
],
"properties": {
"form": {
"type": "string",
"description": "The HTML form for uploading a video through the POST approach."
},
"link": {
"type": "string",
"description": "The link of the video to capture through the pull approach."
},
"size": {
"type": "number",
"example": 60000,
"description": "The file size in bytes of the uploaded video."
},
"status": {
"enum": [
"complete",
"error",
"in_progress"
],
"type": "string",
"example": "complete",
"description": "The status code for the availability of the uploaded video.\n\nOption descriptions:\n * `complete` - The upload is complete.\n * `error` - The upload ended with an error.\n * `in_progress` - The upload is underway.\n"
},
"gcs_uid": {
"type": "string",
"description": "The ID of the Google Cloud Storage upload."
},
"approach": {
"enum": [
"post",
"pull",
"tus"
],
"type": "string",
"example": "post",
"description": "The approach for uploading the video.\n\nOption descriptions:\n * `post` - The video upload uses the POST approach.\n * `pull` - The video upload uses the pull approach.\n * `tus` - The video upload uses the tus approach.\n"
},
"upload_link": {
"type": "string",
"description": "The link for sending video file data."
},
"redirect_url": {
"type": "string",
"description": "The redirect URL for the upload app."
}
},
"description": "The video's upload information."
},
"context": {
"type": "object",
"required": [
"action",
"resource",
"resource_type"
],
"properties": {
"action": {
"enum": [
"Added to",
"Appearance by",
"Liked by",
"Uploaded by"
],
"type": "string",
"example": "Added to",
"description": "The relevant contextual action.\n\nOption descriptions:\n * `Added to` - An Added To action.\n * `Appearance by` - An Appearance By action.\n * `Liked by` - A Liked By action.\n * `Uploaded by` - An Uploaded By action.\n"
},
"resource": {
"type": "object",
"nullable": true,
"description": "The contextual resource: a user, group, or channel representation, or an object of a tag."
},
"resource_type": {
"type": "string",
"example": "clip",
"description": "The contextual resource type."
}
},
"description": "The context of the video's subscription, if the video is part of a subscription."
},
"is_free": {
"type": "boolean",
"example": true,
"description": "Whether the video is a free Vimeo Stock video."
},
"license": {
"enum": [
"by",
"by-nc",
"by-nc-nd",
"by-nc-sa",
"by-nd",
"by-sa",
"cc0"
],
"type": "string",
"example": "by",
"description": "The [Creative Commons](http://creativecommons.org/licenses/) license that the video is given under.\n\nOption descriptions:\n * `by` - The video is given under the Attribution license.\n * `by-nc` - The video is given under the Attribution Non-Commercial license.\n * `by-nc-nd` - The video is given under the Attribution Non-Commercial No Derivatives license.\n * `by-nc-sa` - The video is given under the Attribution Non-Commercial Share Alike license.\n * `by-nd` - The video is given under the Attribution No Derivatives license.\n * `by-sa` - The video is given under the Attribution Share Alike license.\n * `cc0` - The video is given under the Public Domain Dedication license.\n"
},
"privacy": {
"type": "object",
"required": [
"add",
"allow_share_link",
"comments",
"download",
"embed",
"view"
],
"properties": {
"add": {
"type": "boolean",
"example": true,
"description": "Whether the video can be added to collections."
},
"view": {
"enum": [
"anybody",
"contacts",
"disable",
"nobody",
"password",
"ptv",
"ptvhide",
"stock",
"stock_purchased",
"unlisted",
"users"
],
"type": "string",
"example": "anybody",
"description": "The general privacy setting of the video.\n\nOption descriptions:\n * `anybody` - Anyone can access the video. This privacy setting appears as `Public` on the Vimeo front end.\n * `contacts` - Only contacts can access the video. _This field is deprecated._\n * `disable` - The video is hidden from Vimeo. This privacy setting appears as `Hide from Vimeo` on the Vimeo front end.\n * `nobody` - No one besides the owner can access the video. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Anyone with the video's password can access the video.\n * `ptv` - The Vimeo On Demand video is accessible and searchable from Vimeo. _This field is deprecated._\n * `ptvhide` - The Vimeo On Demand video is hidden from Vimeo. _This field is deprecated._\n * `stock` - The stock footage is accessible and searchable from Vimeo. _This field is deprecated._\n * `stock_purchased` - The purchased stock footage is accessible and searchable from Vimeo. _This field is deprecated._\n * `unlisted` - The video is accessible but not searchable from Vimeo.\n * `users` - Only Vimeo members can access the video. _This field is deprecated._\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The video's embed permission setting.\n\nOption descriptions:\n * `private` - The video is private.\n * `public` - Anyone can embed the video.\n * `whitelist` - The video can be embedded on specific domains.\n"
},
"comments": {
"enum": [
"anybody",
"contacts",
"nobody"
],
"type": "string",
"example": "anybody",
"description": "The video's comment permission setting.\n\nOption descriptions:\n * `anybody` - Anyone can comment on the video.\n * `contacts` - Only contacts can comment on the video.\n * `nobody` - No one can comment on the video.\n"
},
"download": {
"type": "boolean",
"example": true,
"description": "Whether the video can be downloaded."
},
"allow_share_link": {
"type": "boolean",
"description": "Whether the share link is usable."
}
},
"description": "The video's privacy setting."
},
"spatial": {
"type": "object",
"required": [
"director_timeline",
"field_of_view",
"projection",
"stereo_format"
],
"properties": {
"projection": {
"enum": [
"cubical",
"cylindrical",
"dome",
"equirectangular",
"pyramid"
],
"type": "string",
"example": "cubical",
"nullable": true,
"description": "The video's 360 spatial projection.\n\nOption descriptions:\n * `cubical` - The spatial projection is cubical.\n * `cylindrical` - The spatial projection is cylindrical.\n * `dome` - The spatial projection is dome-shaped.\n * `equirectangular` - The spatial projection is equirectangular.\n * `pyramid` - The spatial projection is pyramid-shaped.\n"
},
"field_of_view": {
"type": "number",
"example": 50,
"nullable": true,
"description": "The video's 360 field of view value, ranging from a mininum of `30` to a maximum of `90`. The default value is `50`."
},
"stereo_format": {
"enum": [
"left-right",
"mono",
"top-bottom"
],
"type": "string",
"example": "left-right",
"nullable": true,
"description": "The video's 360 stereo format.\n\nOption descriptions:\n * `left-right` - The stereo format is left-right.\n * `mono` - The audio is monaural.\n * `top-bottom` - The stereo format is top-bottom.\n"
},
"director_timeline": {
"type": "array",
"items": {
"type": "object",
"properties": {
"yaw": {
"type": "number",
"example": 125,
"description": "The timeline yaw value, ranging from a minimum of `0` to a maximum of `360`."
},
"roll": {
"type": "number",
"example": 0,
"description": "The timeline roll value."
},
"pitch": {
"type": "number",
"example": 70,
"description": "The timeline pitch value, ranging from a minimum of `-90` to a maximum of `90`."
},
"time_code": {
"type": "number",
"example": 300,
"description": "The timeline time code."
}
}
},
"description": "The video's 360 director timeline."
}
},
"description": "The video's 360 spatial data."
},
"download": {
"type": "array",
"items": {
"$ref": "#/components/schemas/video-file"
},
"description": "The list of downloadable files for the video. This data requires a bearer token with the `private` scope."
},
"duration": {
"type": "number",
"example": 81,
"description": "The video's duration in seconds. A value of `0` indicates the duration hasn't been calculated yet."
},
"language": {
"type": "string",
"example": "en-US",
"nullable": true,
"description": "The video's primary language."
},
"metadata": {
"type": "object",
"required": [
"connections",
"has_chapter_suggestions",
"interactions",
"is_screen_record",
"is_vimeo_create",
"is_webinar",
"is_zoom_upload"
],
"properties": {
"is_webinar": {
"type": "boolean",
"example": true,
"description": "Whether the video is a webinar."
},
"connections": {
"type": "object",
"required": [
"ancestor_path",
"comments",
"credits",
"likes",
"pictures",
"recommendations",
"related",
"resource_creator_team_user",
"texttracks"
],
"properties": {
"likes": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/likes",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 230,
"description": "The total number of likes on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the users who have liked the video."
},
"season": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/season/12345",
"description": "The API URI that resolves to the connection data."
},
"name": {
"type": "string",
"example": "Season 1",
"description": "The name of the season."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video's season."
},
"credits": {
"type": "object",
"nullable": true,
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/credits",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the users credited in the video."
},
"related": {
"type": "object",
"nullable": true,
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937?offset=10",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video's related content."
},
"trailer": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The trailer connection resource key."
}
},
"description": "Information about the video's Vimeo On Demand trailer."
},
"comments": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/comments",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 14,
"description": "The total number of comments on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the comments on the video."
},
"ondemand": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/ondemand/pages/61326",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The On Demand connection resource key."
}
},
"description": "Information about the video's On Demand data."
},
"pictures": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/pictures",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 1,
"description": "Total number of thumbnails on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video's thumbnails."
},
"versions": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/versions",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 3,
"description": "The total number of versions on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"current_uri": {
"type": "string",
"example": "/videos/258684937/versions/12345",
"description": "The URI of the current version of the video."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The resource key string of the current version of the video."
},
"has_interactive": {
"type": "boolean",
"example": false,
"description": "Whether the video has interactive capability."
},
"origin_variable_frame_resolution": {
"type": "boolean",
"example": false,
"description": "Whether the video has unified resolution. If the value of this field is `false`, the video requires transcoding."
}
},
"description": "Information about the video's versions."
},
"texttracks": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/texttracks",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 2,
"description": "The total number of text tracks on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the video's text tracks."
},
"ancestor_path": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ancestor-path"
},
"description": "Information about the video's ancestry, ordered from the direct parent folder to higher-level ancestors."
},
"recommendations": {
"type": "object",
"nullable": true,
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/recommendations",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the recommendations for the video."
},
"team_permissions": {
"type": "object",
"properties": {
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the video's team permissions list. This data requires a bearer token with the `private` scope."
},
"users_with_access": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/privacy/users",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 8,
"description": "The total number of users on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about the user privacy of the video, if the video privacy setting is `users`."
},
"available_channels": {
"type": "object",
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/videos/available_channels",
"description": "The API URI that resolves to the connection data. This data requires a bearer token with the `private` scope."
},
"total": {
"type": "number",
"example": 14,
"description": "The total number of channels on this connection. This data requires a bearer token with the `private` scope."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the channels to which the video can be added. This data requires a bearer token with the `private` scope."
},
"resource_creator_team_user": {
"type": "object",
"required": [
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The URI for the team user who uploaded the video. This data requires a bearer token with the `private` scope."
}
},
"description": "Information about the team user who uploaded the video. This data requires a bearer token with the `private` scope."
}
},
"description": "A list of resource URIs related to the video."
},
"interactions": {
"type": "object",
"required": [
"album",
"ask_ai",
"ask_ai_viewer",
"buy",
"can_request_team_role_upgrade",
"can_update_privacy_to_public",
"channel",
"create_editor",
"delete",
"edit",
"edit_privacy",
"has_restricted_privacy_options",
"highlights",
"invite",
"legal_hold",
"like",
"rent",
"report",
"set_content_rating",
"summary",
"team_mentions",
"transcript_video_editor",
"trim",
"validate",
"view_privacy",
"view_team_members",
"watched",
"watchlater"
],
"properties": {
"buy": {
"type": "object",
"nullable": true,
"required": [
"currency",
"display_price",
"download",
"drm",
"link",
"price",
"purchase_time",
"stream",
"uri"
],
"properties": {
"drm": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand video has DRM."
},
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/products/12345",
"nullable": true,
"description": "The product URI to purchase the On Demand video."
},
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever",
"nullable": true,
"description": "The URL to buy the On Demand video on Vimeo."
},
"price": {
"type": "number",
"example": 5.99,
"nullable": true,
"description": "The price to buy the On Demand video."
},
"stream": {
"enum": [
"available",
"purchased",
"restricted",
"unavailable"
],
"type": "string",
"example": "available",
"description": "The user's streaming access to the On Demand video.\n\nOption descriptions:\n * `available` - The video is available for streaming.\n * `purchased` - The user has purchased the video.\n * `restricted` - The user isn't permitted to stream the video.\n * `unavailable` - The video isn't available for streaming\n"
},
"currency": {
"type": "string",
"example": "USD",
"nullable": true,
"description": "The currency code for the user's region."
},
"download": {
"enum": [
"available",
"purchased",
"restricted",
"unavailable"
],
"type": "string",
"example": "available",
"description": "The user's download access to the On Demand video.\n\nOption descriptions:\n * `available` - The video is available for download.\n * `purchased` - The user has purchased the video.\n * `restricted` - The user isn't permitted to download the video.\n * `unavailable` - The video isn't available for download.\n"
},
"display_price": {
"type": "string",
"example": "5.99",
"nullable": true,
"description": "The formatted display price for buying the On Demand video."
},
"purchase_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the On Demand video was purchased."
}
},
"description": "The Buy interaction for the On Demand video."
},
"edit": {
"type": "object",
"nullable": true,
"required": [
"blocked_fields",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"blocked_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of video fields that a user can't interact with."
}
},
"description": "Information about where and how to edit a video."
},
"like": {
"type": "object",
"required": [
"added",
"added_time",
"options",
"show_count",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the user has liked the video."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"added_time": {
"type": "string",
"description": "The time in ISO 8601 format when the user liked the video."
},
"show_count": {
"type": "boolean",
"description": "Whether the user can access the video's number of likes."
}
},
"description": "Information about whether the user has liked this video."
},
"rent": {
"type": "object",
"nullable": true,
"required": [
"currency",
"display_price",
"drm",
"expires_time",
"link",
"price",
"purchase_time",
"stream",
"uri"
],
"properties": {
"drm": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand video has DRM."
},
"uri": {
"type": "string",
"example": "/ondemand/pages/61326/products/12345",
"nullable": true,
"description": "The product URI to rent the On Demand video."
},
"link": {
"type": "string",
"example": "https://vimeo.com/ondemand/darbyforever",
"nullable": true,
"description": "The URL to rent the On Demand video on Vimeo."
},
"price": {
"type": "number",
"example": 5.99,
"nullable": true,
"description": "The price to buy the On Demand video."
},
"stream": {
"enum": [
"available",
"purchased",
"restricted",
"unavailable"
],
"type": "string",
"example": "available",
"description": "The user's streaming access to the On Demand video.\n\nOption descriptions:\n * `available` - The video is available for streaming.\n * `purchased` - The user has purchased the video.\n * `restricted` - The user isn't permitted to stream the video.\n * `unavailable` - The video isn't available for streaming.\n"
},
"currency": {
"type": "string",
"example": "USD",
"nullable": true,
"description": "The currency code for the user's region."
},
"expires_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the rental period for the On Demand video expires."
},
"display_price": {
"type": "string",
"example": "5.99",
"nullable": true,
"description": "The formatted display price for renting the On Demand video."
},
"purchase_time": {
"type": "string",
"example": "2018-09-16T09:02:40+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the On Demand video was rented."
}
},
"description": "The Rent interaction for the On Demand video."
},
"trim": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to trim the video."
},
"album": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about adding or removing a video from the showcase. This information is included only when the video is referenced by the URI of a showcase that's moderated by the user."
},
"ask_ai": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to submit questions to the AI service for this video."
},
"delete": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to delete a video."
},
"invite": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to get a list of team members\nor groups who were explicitly invited to a video, and where and how to invite a team member to a video."
},
"report": {
"type": "object",
"required": [
"options",
"reason",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"reason": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of valid reasons for reporting a video."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to report a video."
},
"channel": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about removing a video from the channel. This information is included only when the video is referenced by the URI of a channel that's moderated by the user."
},
"summary": {
"type": "object",
"nullable": true,
"required": [
"disabled",
"options",
"reason",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"reason": {
"enum": [
"transcript_ready_but_not_english",
"transcript_status_does_not_exist",
"transcript_status_exceeds_maximum_duration",
"transcript_status_failed",
"transcript_status_in_progress",
"transcript_status_language_not_supported",
"transcript_status_no_speech",
"transcript_status_not_started",
"transcript_status_unknown",
"video_not_ready",
"video_too_short"
],
"type": "string",
"example": "transcript_ready_but_not_english",
"nullable": true,
"description": "The reason why the summary method is disabled.\n\nOption descriptions:\n * `transcript_ready_but_not_english` - The transcript is ready, but isn't in English.\n * `transcript_status_does_not_exist` - The transcript doesn't exist.\n * `transcript_status_exceeds_maximum_duration` - The transcript duration is too long.\n * `transcript_status_failed` - The transcript job failed.\n * `transcript_status_in_progress` - The transcript job is in progress.\n * `transcript_status_language_not_supported` - The transcript's language isn't supported.\n * `transcript_status_no_speech` - There's no speech detected for the transcript.\n * `transcript_status_not_started` - The transcript job hasn't started.\n * `transcript_status_unknown` - The transcript job status is unknown.\n * `video_not_ready` - The video isn't ready.\n * `video_too_short` - The video is too short.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"disabled": {
"type": "boolean",
"description": "Whether the summary method is disabled."
}
},
"description": "Information about whether the current user can create or get a summary for the video."
},
"watched": {
"type": "object",
"required": [
"added",
"added_time",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the user has watched the video."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"added_time": {
"type": "string",
"description": "The time in ISO 8601 format when the user watched the video."
}
},
"description": "Information about removing this video from the user's list of watched videos."
},
"validate": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to validate a video field."
},
"subscribe": {
"type": "object",
"nullable": true,
"properties": {
"drm": {
"type": "boolean",
"example": true,
"description": "Whether the On Demand video has DRM."
},
"stream": {
"type": "string",
"example": "purchased",
"description": "The stream type."
},
"expires_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the subscription expires."
},
"purchase_time": {
"type": "string",
"example": "2018-03-02T21:04:47+00:00",
"description": "The time in ISO 8601 format when the subscription was purchased."
}
},
"description": "Subscription information for an On Demand video."
},
"highlights": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to create a highlight for the video."
},
"legal_hold": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "The associated legal hold object."
},
"watchlater": {
"type": "object",
"required": [
"added",
"added_time",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"added": {
"type": "boolean",
"example": true,
"description": "Whether the user has added the video to their Watch Later list."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"added_time": {
"type": "string",
"description": "The time in ISO 8601 format when the user added the video to their Watch Later list."
}
},
"description": "Information about whether this video appears on the user's Watch Later list."
},
"edit_privacy": {
"type": "object",
"nullable": true,
"required": [
"content_rating",
"options",
"properties",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"properties": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"options",
"required"
],
"properties": {
"name": {
"type": "string",
"description": "The name of the property to be sent."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the field's selectable options."
},
"required": {
"type": "boolean",
"description": "Whether the field must be sent to achieve the desired action."
}
}
},
"description": "An array of suggested fields to be used for this interaction."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of valid content rating flags for the video."
}
},
"description": "Information about editing the privacy of the video."
},
"view_privacy": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about whether a user has permissions to view the privacy of the video."
},
"ask_ai_viewer": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to submit questions by viewers to the AI service for this video."
},
"create_editor": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit a video using the Vimeo Create editor."
},
"team_mentions": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about whether a user can mention the team members and commented users associated with a video."
},
"view_team_members": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about whether a user can view the team members associated with a video."
},
"set_content_rating": {
"type": "object",
"nullable": true,
"required": [
"content_rating",
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"content_rating": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of valid content rating flags for the video."
}
},
"description": "Information about setting a content rating for the video."
},
"transcript_video_editor": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit a video using the Transcription-based Video Editor editor."
},
"can_update_privacy_to_public": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Whether a user can update the video privacy to public."
},
"can_request_team_role_upgrade": {
"type": "object",
"nullable": true,
"required": [
"options",
"properties",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
},
"properties": {
"type": "object",
"required": [
"folder_uri",
"status",
"upgrade_to_role"
],
"properties": {
"status": {
"type": "object",
"required": [
"required",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The status of the role upgrade request to which the team member should have access."
},
"required": {
"type": "boolean",
"description": "Whether the status of the role upgrade request must be sent to achieve the desired action."
}
},
"description": "An object containing data on the value of **status** and whether it's required for the interaction."
},
"folder_uri": {
"type": "object",
"required": [
"required",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The URI of the folder to which the team member should have access."
},
"required": {
"type": "boolean",
"description": "Whether the URI of the folder must be sent to achieve the desired action."
}
},
"description": "An object containing data on the value of **folder_uri** and whether it's required for the interaction."
},
"upgrade_to_role": {
"type": "object",
"required": [
"required",
"value"
],
"properties": {
"value": {
"type": "number",
"description": "The value of the team role to which the user should be upgraded."
},
"required": {
"type": "boolean",
"description": "Whether the upgrade role must be sent to achieve the desired action."
}
},
"description": "An object containing data on the value of **upgrade_to_role** and whether it's required for the interaction."
}
},
"description": "An object of suggested fields to be used for this interaction."
}
},
"description": "Information about whether the user can request a team upgrade from the Viewer role."
},
"has_restricted_privacy_options": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about whether the video has restricted privacy options."
}
},
"description": "A list of resource URIs related to the video."
},
"is_zoom_upload": {
"type": "boolean",
"example": true,
"description": "Whether the video is a Zoom upload."
},
"can_be_replaced": {
"type": "boolean",
"example": true,
"description": "Whether the video can be replaced."
},
"is_vimeo_create": {
"type": "boolean",
"example": true,
"description": "Whether the video is a Vimeo Create video."
},
"is_screen_record": {
"type": "boolean",
"example": true,
"description": "Whether the video is a screen recording."
},
"has_email_capture": {
"type": "boolean",
"example": true,
"description": "Whether the video has the email capture feature."
},
"has_chapter_suggestions": {
"type": "boolean",
"example": true,
"description": "Whether the video has chapter suggestions."
}
},
"description": "The video's metadata."
},
"password": {
"type": "string",
"example": "hunter1",
"description": "The privacy-enabled password to watch the video. Only the video's owner and team members with permission can access the video's password. This data requires a bearer token with the `private` scope."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"uploader": {
"type": "object",
"required": [
"link",
"name",
"pictures"
],
"properties": {
"link": {
"type": "string",
"description": "The profile link of the user who uploaded the video."
},
"name": {
"type": "string",
"description": "The display name of the user who uploaded the video."
},
"pictures": {
"$ref": "#/components/schemas/picture"
}
},
"description": "The video's uploader.",
"x-konfig-properties": {
"pictures": {
"description": "The active portrait of the user who uploaded the video."
}
}
},
"has_audio": {
"type": "boolean",
"description": "Whether the video has audio."
},
"transcode": {
"type": "object",
"nullable": true,
"properties": {
"status": {
"enum": [
"complete",
"error",
"in_progress"
],
"type": "string",
"example": "complete",
"description": "The video's availability status.\n\nOption descriptions:\n * `complete` - Transcoding is complete. The video is available.\n * `error` - There was a transcoding error. The video isn't available.\n * `in_progress` - Transcoding is currently underway. The video isn't available yet.\n"
}
},
"description": "The transcode information of the video upload."
},
"categories": {
"type": "array",
"items": {
"$ref": "#/components/schemas/category"
},
"description": "The categories that the video belongs to."
},
"custom_url": {
"type": "string",
"nullable": true,
"description": "The custom URL of the video."
},
"transcript": {
"type": "object",
"nullable": true,
"required": [
"language"
],
"properties": {
"status": {
"enum": [
"completed",
"failed",
"in_progress",
"language_not_supported",
"no_speech",
"not_started",
"unknown"
],
"type": "string",
"example": "completed",
"description": "The video transcript's availability status. This data requires a bearer token with the `private` scope.\n\nOption descriptions:\n * `completed` - Transcription is completed. The transcript is available.\n * `failed` - There was a transcription error. The transcript isn't available.\n * `in_progress` - Transcription is currently underway. The transcript isn't available yet.\n * `language_not_supported` - We currently don't support transcribing audio for this video's language.\n * `no_speech` - Transcription was completed, but there were no words in the audio to transcribe.\n * `not_started` - The transcript job hasn't started.\n * `unknown` - There isn't a record of this video's transcription job.\n"
},
"language": {
"type": "string",
"example": "en",
"nullable": true,
"description": "The video transcript's language. This data requires a bearer token with the `private` scope."
}
},
"description": "The transcript information of the video. This data requires a bearer token with the `private` scope."
},
"description": {
"type": "string",
"example": "A celebration of 10 years of Staff Picks.",
"nullable": true,
"description": "A brief explanation of the video's content."
},
"is_playable": {
"type": "boolean",
"description": "Whether the video is playable."
},
"manage_link": {
"type": "string",
"example": "/manage/videos/258684937",
"description": "The link to the video management page. This data requires a bearer token with the `private` scope."
},
"created_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the video was created."
},
"edit_session": {
"$ref": "#/components/schemas/editing-session"
},
"has_chapters": {
"type": "boolean",
"description": "Whether the video has chapters."
},
"release_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the video was released."
},
"resource_key": {
"type": "string",
"example": "bac1033deba2310ebba2caec33c23e4beea67aba",
"description": "The resource key string of the video."
},
"modified_time": {
"type": "string",
"example": "2018-09-16T09:02:40+00:00",
"description": "The time in ISO 8601 format when the video metadata was last modified."
},
"parent_folder": {
"allOf": [
{
"$ref": "#/components/schemas/project"
}
],
"nullable": true,
"description": "Information about the folder that contains the video."
},
"content_rating": {
"enum": [
"advertisement",
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "advertisement"
},
"description": "The video's granular content rating.\n\nOption descriptions:\n * `advertisement` - The video contains advertisements.\n * `drugs` - The video contains drug or alcohol use.\n * `language` - The video contains profanity or sexually suggestive content.\n * `nudity` - The video contains nudity.\n * `safe` - The video is safe for all audiences.\n * `unrated` - The video hasn't been rated.\n * `violence` - The video contains violence.\n"
},
"has_interactive": {
"type": "boolean",
"example": false,
"description": "Whether the video has interactive capability."
},
"has_text_tracks": {
"type": "boolean",
"description": "Whether the video has text tracks."
},
"description_html": {
"type": "string",
"example": "<p>A celebration of <b>10 years</b> of Staff Picks.</p>",
"nullable": true,
"description": "A brief explanation of the video's content, formatted with HTML entities."
},
"description_rich": {
"type": "string",
"example": "{\"ops\":[{\"insert\": \"Text\"}]}",
"description": "A JSON representation of the description."
},
"has_audio_tracks": {
"type": "boolean",
"description": "Whether the video has alternate audio tracks."
},
"player_embed_url": {
"type": "string",
"example": "https://player.vimeo.com/video/258684937?h=c893f64dd6",
"description": "The video's player embed URL."
},
"show_review_page": {
"type": "boolean",
"nullable": true,
"description": "Whether to show the `Review` button on single video view recipient pages. This data requires a bearer token with the `private` scope."
},
"allowed_privacies": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of privacy settings supported for this video and the requesting user."
},
"rating_mod_locked": {
"type": "boolean",
"description": "Whether the video's content rating is locked by a mod."
},
"can_move_to_project": {
"type": "boolean",
"nullable": true,
"description": "Whether the video can be moved to a folder. This data requires a bearer token with the `private` scope."
},
"content_rating_class": {
"enum": [
"explicit",
"safe",
"unrated"
],
"type": "string",
"example": "explicit",
"description": "The video's high-level content rating class.\n\nOption descriptions:\n * `explicit` - The video contains one or more explicit content rating types.\n * `safe` - The video contains no explicit content rating types.\n * `unrated` - The video doesn't belong to a content rating class.\n"
},
"show_svv_footer_banner": {
"type": "boolean",
"nullable": true,
"description": "Whether to show the single video view footer banner on recipient pages. This data requires a bearer token with the `private` scope."
},
"is_copyright_restricted": {
"type": "boolean",
"description": "Whether the video is privacy restricted due to a copyright infringement. This data requires a bearer token with the `private` scope."
},
"version_transcode_status": {
"$ref": "#/components/schemas/version-transcode-status"
},
"last_user_action_event_date": {
"type": "string",
"example": "2018-03-21T23:08:22+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the user last modified the video."
},
"show_svv_timecoded_comments": {
"type": "boolean",
"nullable": true,
"description": "Whether to enable timecoded comments on the single video view recipient page. This data requires a bearer token with the `private` scope."
},
"origin_variable_frame_resolution": {
"type": "boolean",
"example": false,
"description": "Whether the video has unified resolution. If the value of this field is `false`, the video requires transcoding."
}
},
"x-konfig-properties": {
"app": {
"description": "The API application associated with the video owner's token."
},
"play": {
"description": "The `Play` representation."
},
"embed": {
"description": "Information about embedding the video."
},
"pictures": {
"description": "The video's active picture."
},
"edit_session": {
"description": "Information about the video's Vimeo Create editing session. This data requires a bearer token with the `private` scope."
},
"version_transcode_status": {
"description": "Detailed transcode status information for the current version of the video upload."
}
}
}
video-file
{
"type": "object",
"title": "Video File",
"required": [
"codec",
"created_time",
"fps",
"height",
"link",
"md5",
"public_name",
"quality",
"rendition",
"size",
"size_short",
"type",
"width"
],
"properties": {
"fps": {
"type": "number",
"example": 30,
"description": "The frames per second of the video."
},
"log": {
"type": "object",
"properties": {
"play": {
"type": "string",
"example": "https://api.vimeo.com/videos/258684937/stats/play/ts/1537137531:d8a2bbf8617cf/887133875",
"description": "The URL to record a Play logging event."
}
}
},
"md5": {
"type": "string",
"example": "1bc29b36f623ba82aaf6724fd3b16718",
"description": "The MD5 hash of the video file."
},
"link": {
"type": "string",
"example": "https://player.vimeo.com/play/965853365?s=258684937_1537148280_a749040a9205",
"description": "The direct link to the video file."
},
"size": {
"type": "number",
"example": 9932503,
"nullable": true,
"description": "The approximate size in bytes of the video file."
},
"type": {
"enum": [
"source",
"video/mp4",
"video/webm",
"vp6/x-video"
],
"type": "string",
"example": "source",
"nullable": true,
"description": "The type of video file.\n\nOption descriptions:\n * `source` - The video file is a source file.\n * `video/mp4` - The video file is in MP4 format.\n * `video/webm` - The video file is in WebM format.\n * `vp6/x-video` - The video file is in VP6 format.\n"
},
"codec": {
"enum": [
"AV1",
"H264",
"HEVC"
],
"type": "string",
"example": "AV1",
"nullable": true,
"description": "The codec of the video file.\n\nOption descriptions:\n * `AV1` - The codec is AV1.\n * `H264` - The codec is H264.\n * `HEVC` - The codec is HEVC.\n"
},
"width": {
"type": "number",
"example": 1920,
"nullable": true,
"description": "The width of the video in pixels."
},
"height": {
"type": "number",
"example": 1080,
"nullable": true,
"description": "The height of the video in pixels."
},
"expires": {
"type": "string",
"example": "2017-05-17T15:41:00+00:00",
"description": "The time in ISO 8601 format when the video file expires."
},
"quality": {
"enum": [
"hd",
"hls",
"mobile",
"sd",
"source",
"uhd"
],
"type": "string",
"example": "hd",
"description": "The video quality as determined by height and width.\n\nOption descriptions:\n * `hd` - The video is in high definition.\n * `hls` - The video is suitable for HTTP live streaming.\n * `mobile` - The video is mobile quality.\n * `sd` - The video is in standard definition.\n * `source` - The video's source file.\n * `uhd` - The video resolution is 2K or higher.\n"
},
"rendition": {
"enum": [
"1080p",
"240p",
"2k",
"360p",
"480p",
"4k",
"540p",
"5k",
"6k",
"720p",
"7k",
"8k",
"adaptive",
"source"
],
"type": "string",
"example": "1080p",
"description": "The video rendition.\n\nOption descriptions:\n * `1080p` - The video has 1080p resolution.\n * `240p` - The video has 240p resolution.\n * `2k` - The video has 2K resolution.\n * `360p` - The video has 360p resolution.\n * `480p` - The video has 480p resolution.\n * `4k` - The video has 4K resolution.\n * `540p` - The video has 540p resolution.\n * `5k` - The video has 5K resolution.\n * `6k` - The video has 6K resolution.\n * `720p` - The video has 720p resolution.\n * `7k` - The video has 7K resolution.\n * `8k` - The video has 8K resolution.\n * `adaptive` - The video rendition is adaptive (for example, HLS or DASH).\n * `source` - The video is the source file.\n"
},
"size_short": {
"type": "string",
"example": "17.89MB",
"description": "The converted size of the video file rounded to two decimal places."
},
"public_name": {
"type": "string",
"example": "HD 720p",
"description": "The public name of the video file."
},
"source_link": {
"type": "string",
"example": "https://player.vimeo.com/source/965853365?s=258684937",
"nullable": true,
"description": "The source link of the video file."
},
"created_time": {
"type": "string",
"example": "2017-05-16T15:41:36+00:00",
"description": "The time in ISO 8601 format when the video file was created."
},
"video_file_id": {
"type": "string",
"example": "b9ec9728-aa28-4fcd-9cc8-02944798c712",
"description": "The ID of the video file."
}
}
}
video-version
{
"type": "object",
"title": "Video Version",
"required": [
"active",
"app",
"audio_track_quota",
"can_restore_create",
"create_storyboard_id",
"created_time",
"download_config",
"duration",
"filename",
"filesize",
"has_interactive",
"metadata",
"modified_time",
"origin_variable_frame_resolution",
"transcode",
"upload",
"upload_date",
"uri",
"user"
],
"properties": {
"app": {
"$ref": "#/components/schemas/api-app"
},
"uri": {
"type": "string",
"example": "/videos/258684937/versions/12345",
"description": "The version's canonical relative URI."
},
"play": {
"$ref": "#/components/schemas/play"
},
"user": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The owner of the video version."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the video version is currently active."
},
"upload": {
"type": "object",
"nullable": true,
"required": [
"status"
],
"properties": {
"form": {
"type": "string",
"description": "The HTML form for uploading a video through the POST approach."
},
"link": {
"type": "string",
"description": "The link of the video to capture through the pull approach."
},
"size": {
"type": "number",
"example": 60000,
"description": "The file size in bytes of the uploaded video."
},
"status": {
"enum": [
"complete",
"error",
"in_progress"
],
"type": "string",
"example": "complete",
"description": "The status code for the availability of the uploaded video.\n\nOption descriptions:\n * `complete` - The upload is complete.\n * `error` - The upload ended with an error.\n * `in_progress` - The upload is underway.\n"
},
"gcs_uid": {
"type": "string",
"description": "The ID of the Google Cloud Storage upload."
},
"approach": {
"enum": [
"post",
"pull",
"tus"
],
"type": "string",
"example": "post",
"description": "The approach for uploading the video.\n\nOption descriptions:\n * `post` - The video upload uses the POST approach.\n * `pull` - The video upload uses the pull approach.\n * `tus` - The video upload uses the tus approach.\n"
},
"upload_link": {
"type": "string",
"description": "The link for sending video file data."
},
"redirect_url": {
"type": "string",
"description": "The redirect URL for the upload app."
}
},
"description": "The version's upload information."
},
"duration": {
"type": "number",
"example": 81,
"nullable": true,
"description": "The duration in seconds of the video version."
},
"filename": {
"type": "string",
"example": "rev2.mp4",
"description": "The file name of the video version."
},
"filesize": {
"type": "number",
"example": 4025322521,
"nullable": true,
"description": "The size in byes of the video version file."
},
"metadata": {
"type": "object",
"required": [
"connections"
],
"properties": {
"connections": {
"type": "object",
"required": [
"video"
],
"properties": {
"video": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 5,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Data from the video associated with the version."
}
}
}
},
"description": "The video version's metadata."
},
"transcode": {
"type": "object",
"nullable": true,
"properties": {
"status": {
"enum": [
"complete",
"error",
"in_progress"
],
"type": "string",
"example": "complete",
"description": "The status code for the availability of the video version.\n\nOption descriptions:\n * `complete` - Transcoding is complete. The video version is available.\n * `error` - There was a transcoding error. The video version isn't available.\n * `in_progress` - Transcoding is in progress. The video version isn't available yet.\n"
}
},
"description": "The version's transcode information."
},
"description": {
"type": "string",
"example": "description with emoji",
"description": "A description of the video version. This description can make use of the full unicode character set. This field appears in the response only when a corresponding value is present."
},
"upload_date": {
"type": "string",
"example": "2018-09-16T09:02:40+00:00",
"nullable": true,
"description": "The time in ISO 8601 format when the video version was uploaded."
},
"created_time": {
"type": "string",
"example": "2018-03-05T21:04:47+00:00",
"description": "The time in ISO 8601 format when the video version was created."
},
"modified_time": {
"type": "string",
"example": "2018-09-16T09:02:40+00:00",
"description": "The time in ISO 8601 format when the video version was last modified."
},
"download_config": {
"type": "object",
"description": "The download config associated with the version."
},
"has_interactive": {
"type": "boolean",
"example": false,
"description": "Whether the video has interactive capability."
},
"audio_track_quota": {
"type": "object",
"required": [
"free",
"has_reached_quota",
"max",
"used"
],
"properties": {
"max": {
"type": "number",
"description": "The maximum number of audio tracks that the user can upload per version based on their subscription tier."
},
"free": {
"type": "number",
"description": "The number of audio tracks availible for this version."
},
"used": {
"type": "number",
"description": "The number of audio tracks used for this version."
},
"has_reached_quota": {
"type": "boolean",
"description": "Whether the current version has reached its maximum quota for audio tracks."
}
},
"description": "The quota parameters for the audio tracks available for this version."
},
"can_restore_create": {
"type": "boolean",
"example": false,
"description": "Whether the version can be restored."
},
"create_storyboard_id": {
"type": "string",
"example": "storyboard_123456_1000",
"description": "The storyboard ID of the video version."
},
"origin_variable_frame_resolution": {
"type": "boolean",
"example": false,
"description": "Whether the video has unified resolution. If the value of this field is `false`, the video requires transcoding."
}
},
"x-konfig-properties": {
"app": {
"description": "The API app associated with the video version."
},
"play": {
"description": "The `Play` representation."
}
}
}
webinar
{
"type": "object",
"title": "Webinar",
"required": [
"completed_on",
"converted_to_event",
"created_time",
"description",
"edit",
"email_provider_list",
"email_quota",
"email_settings",
"events",
"has_polls",
"metadata",
"modified_on",
"next_occurrence_time",
"password",
"privacy",
"registration_data",
"registration_form",
"schedule",
"status",
"time_zone",
"title",
"uri",
"user"
],
"properties": {
"uri": {
"type": "string",
"example": "/webinars/f19bfa08-b266-4f20-bfce-db1d0719b52f",
"description": "The webinar's canonical relative URI."
},
"edit": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit an item."
},
"user": {
"$ref": "#/components/schemas/user"
},
"title": {
"type": "string",
"example": "Live Content",
"nullable": true,
"description": "The title of the webinar."
},
"events": {
"type": "object",
"nullable": true,
"required": [
"data",
"total"
],
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/webinar-event"
},
"description": "The details of the first page of webinar events associated with the webinar."
},
"total": {
"type": "number",
"example": 4,
"description": "The total number of webinar events associated with the webinar."
}
},
"description": "The details of the webinar events associated with the webinar."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"nullable": true,
"description": "The status of the webinar.\n\nOption descriptions:\n * `ended` - The webinar has ended.\n * `started` - The webinar has started.\n"
},
"privacy": {
"type": "object",
"required": [
"embed",
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"nobody",
"password",
"team"
],
"type": "string",
"example": "anybody",
"description": "The general privacy setting for the webinar.\n\nOption descriptions:\n * `anybody` - Anyone can access the webinar. This privacy setting appears as `Public` on the Vimeo front end.\n * `nobody` - Only the event owner can access the webinar. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the live event.\n * `team` - Only members of the authenticated user's team can access the webinar.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "private",
"description": "The webinar's embed permission setting.\n\nOption descriptions:\n * `private` - The webinar can't be embedded on any domain.\n * `public` - The webinar can be embedded on any domain.\n * `whitelist` - The webinar can be embedded on whitelisted domains only.\n"
}
},
"description": "The initial privacy settings of the webinar."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"description": "A list of resource URIs related to the webinar."
},
"interactions": {
"type": "object",
"description": "A list of resource URIs related to the event."
}
},
"description": "Metadata about the webinar event."
},
"password": {
"type": "string",
"example": "gogo",
"nullable": true,
"description": "The password used to access the videos generated by streaming to the webinar event."
},
"schedule": {
"type": "object",
"nullable": true,
"required": [
"daily_time",
"end_time",
"scheduled_time",
"start_time",
"type",
"weekdays"
],
"properties": {
"type": {
"enum": [
"single",
"weekly"
],
"type": "string",
"example": "weekly",
"description": "The schedule of the webinar.\n\nOption descriptions:\n * `single` - The webinar is live only once.\n * `weekly` - The webinar is live on a recurring weekly basis.\n"
},
"end_time": {
"type": "string",
"example": "2019-06-21T14:00:00+00:00",
"description": "The date in ISO 8601 format on which the webinar is expected to end. This field applies when **schedule.type** is `single`."
},
"weekdays": {
"type": "array",
"items": {
"type": "string"
},
"description": "The weekdays in UTC on which the webinar is expected to be live when **schedule.time** is `weekly`. The value of this field ranges from `1` to `7`, where `1` is Monday and `7` is Sunday."
},
"daily_time": {
"type": "string",
"example": "14:00:00Z",
"description": "The time in ISO 8601 format at which the webinar is expected to be live when **schedule.type** is `weekly`."
},
"start_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"description": "The date in ISO 8601 format on which the webinar is expected to be live when **schedule.type** is `single`."
},
"scheduled_time": {
"type": "string",
"example": "2018-06-21T14:00:00+00:00",
"nullable": true,
"description": "The date in ISO 8601 format on which the first occurrence of the webinar is expected to be live when **schedule.type** is `weekly`."
}
},
"description": "The description of the time or times that the webinar is expected to be live."
},
"has_polls": {
"type": "boolean",
"example": false,
"description": "Whether polls are associated with the webinar."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps that are included in the automatically generated video titles for the webinar."
},
"description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"nullable": true,
"description": "The description of the webinar."
},
"email_quota": {
"type": "object",
"required": [
"capping",
"total"
],
"properties": {
"total": {
"type": "number",
"example": 300,
"description": "The current number of webinar emails that the user has sent."
},
"capping": {
"type": "number",
"example": 400,
"description": "The maximum number of webinar emails that the user can send."
}
},
"description": "Information about the webinar owner's email quota."
},
"modified_on": {
"type": "string",
"example": "2023-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the webinar was modified."
},
"completed_on": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the webinar was completed."
},
"created_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the webinar was created."
},
"email_settings": {
"$ref": "#/components/schemas/webinar-email-settings"
},
"registration_data": {
"type": "object",
"required": [
"capping",
"is_unlimited",
"lower_limit",
"total",
"upper_limit"
],
"properties": {
"total": {
"type": "number",
"example": 103,
"description": "The number of registrants who have signed up for the webinar."
},
"capping": {
"type": "number",
"example": 400,
"description": "The maximum number of registrants permitted to attend the webinar."
},
"lower_limit": {
"type": "number",
"example": 160,
"description": "The minimum number of registrants to trigger the 80% capping email."
},
"upper_limit": {
"type": "number",
"example": 200,
"description": "The maximum number of registrants to trigger the 100% capping email."
},
"is_unlimited": {
"type": "boolean",
"example": true,
"description": "Whether the number of registrants is unlimited."
}
},
"description": "Registration data about the webinar owner."
},
"registration_form": {
"$ref": "#/components/schemas/email-capture-form"
},
"converted_to_event": {
"type": "boolean",
"description": "Whether the webinar has been converted into an event."
},
"email_provider_list": {
"type": "array",
"items": {
"type": "object",
"required": [
"is_active",
"last_import_time",
"list",
"provider"
],
"properties": {
"list": {
"type": "object",
"nullable": true,
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"example": "1234abcd",
"description": "The ID of the connected list."
},
"name": {
"type": "string",
"example": "My List",
"description": "The name of the connected list."
}
},
"description": "Information about the connected list."
},
"provider": {
"type": "object",
"required": [
"dark_icon",
"icon",
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"example": "marketo",
"description": "The ID of the connected provider."
},
"icon": {
"type": "string",
"example": "http:://xyz.icon",
"description": "The standard icon of the connected provider."
},
"name": {
"type": "string",
"example": "Marketo",
"description": "The name of the connected provider."
},
"dark_icon": {
"type": "string",
"example": "http:://xyz.dark_icon",
"description": "The dark icon of the connected provider."
}
},
"description": "Information about the connected provider."
},
"is_active": {
"type": "boolean",
"example": false,
"description": "Whether the connection is active."
},
"last_import_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The most recent sync date of the provider list."
}
}
},
"description": "Information about the email provider list that is selected to import registrants."
},
"next_occurrence_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The date in ISO 8601 format on which the next occurrence of the webinar is expected to be live."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the webinar."
},
"email_settings": {
"description": "The settings for emails that are sent about the webinar."
},
"registration_form": {
"description": "The registration form settings associated with the webinar."
}
}
}
webinar-email-content
{
"type": "object",
"title": "Webinar Email Content",
"required": [
"body",
"button_link",
"button_text",
"header",
"modified_time",
"subject",
"type",
"use_calender",
"use_custom_link"
],
"properties": {
"body": {
"type": "string",
"example": "<p style=\"text-align:left;\"> This email is all about the webinar.</p>",
"description": "The HTML body of the email."
},
"type": {
"enum": [
"email_event_reminder_24_hrs",
"email_post_event_thank_you",
"email_registration_confirmation"
],
"type": "string",
"example": "email_registration_confirmation",
"description": "The email type for which the content was customized.\n\nOption descriptions:\n * `email_event_reminder_24_hrs` - The webinar reminder email, which goes out 24 hours before the event.\n * `email_post_event_thank_you` - The webinar post-event thank-you email.\n * `email_registration_confirmation` - The webinar registration confirmation email.\n"
},
"header": {
"type": "string",
"example": "<h3> Welcome to the webinar </h3>",
"description": "The HTML header section of the email."
},
"subject": {
"type": "string",
"example": "ABC is Hiring",
"description": "The HTML subject of the email."
},
"button_link": {
"type": "string",
"example": "https://vimeo.com",
"description": "The target link for the call-to-action button in the email."
},
"button_text": {
"type": "string",
"example": "Join now",
"description": "The text for the call-to-action button in the email."
},
"use_calender": {
"type": "boolean",
"example": true,
"description": "Whether to show the calendar in the email."
},
"modified_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the webinar email content was updated."
},
"use_custom_link": {
"type": "boolean",
"example": true,
"description": "Whether to include a custom link in emails that are sent about the webinar."
}
}
}
webinar-email-settings
{
"type": "object",
"title": "Webinar Email Settings",
"required": [
"accent_color",
"custom_link",
"email_event_reminder_24_hrs",
"email_post_event_thank_you",
"email_preferences",
"email_registration_confirmation",
"follow_up_send_on",
"follow_up_sender",
"from",
"logo_uri",
"pictures",
"reply_email",
"sender_address",
"sender_policy_url",
"use_custom_link",
"use_reply_email",
"use_sender_address",
"use_sender_policy_url"
],
"properties": {
"from": {
"type": "string",
"example": "Vimeo",
"description": "The name of the sender for emails that are sent about the webinar."
},
"logo_uri": {
"type": "string",
"example": "/users/1234/team_logos/234",
"nullable": true,
"description": "The URI of the logo image to include in emails that are sent about the webinar."
},
"pictures": {
"allOf": [
{
"$ref": "#/components/schemas/picture"
}
],
"nullable": true,
"description": "The logo to include in emails that are sent about the webinar."
},
"custom_link": {
"type": "string",
"example": "https://vimeo.com",
"nullable": true,
"description": "The custom link for emails that are sent about the webinar."
},
"reply_email": {
"type": "string",
"example": "test@vimeo.com",
"nullable": true,
"description": "The sender's reply email address."
},
"accent_color": {
"type": "string",
"example": "#00000f",
"description": "The accent color scheme for emails that are sent about the webinar."
},
"sender_address": {
"type": "string",
"example": "Bangalore, India",
"nullable": true,
"description": "The sender's physical address."
},
"use_custom_link": {
"type": "boolean",
"example": true,
"description": "Whether to include a custom link in emails that are sent about the webinar."
},
"use_reply_email": {
"type": "boolean",
"example": false,
"description": "Whether to include a reply link in the footer of emails that are sent about the webinar."
},
"follow_up_sender": {
"allOf": [
{
"$ref": "#/components/schemas/user"
}
],
"nullable": true,
"description": "The user who manually triggered the follow-up email."
},
"email_preferences": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of preferences for the emails to send during the webinar event."
},
"follow_up_send_on": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the follow-up email was sent."
},
"sender_policy_url": {
"type": "string",
"example": "https://vimeo.com/policy",
"nullable": true,
"description": "The URL of the sender's privacy policy."
},
"use_sender_address": {
"type": "boolean",
"example": false,
"description": "Whether to include the sender's physical address in the footer of emails that are sent about the webinar."
},
"use_sender_policy_url": {
"type": "boolean",
"example": false,
"description": "Whether to include the URL of the sender's privacy policy in the footer of emails that are sent about the webinar."
},
"email_post_event_thank_you": {
"type": "object",
"required": [
"custom",
"default"
],
"properties": {
"custom": {
"allOf": [
{
"$ref": "#/components/schemas/webinar-email-content"
}
],
"nullable": true,
"description": "The email custom details for the webinar post-event thank-you email."
},
"default": {
"$ref": "#/components/schemas/webinar-email-content"
}
},
"description": "The email customization details for the webinar post-event thank-you email.",
"x-konfig-properties": {
"default": {
"description": "The email default details for the webinar post-event thank-you email."
}
}
},
"email_event_reminder_24_hrs": {
"type": "object",
"required": [
"custom",
"default"
],
"properties": {
"custom": {
"allOf": [
{
"$ref": "#/components/schemas/webinar-email-content"
}
],
"nullable": true,
"description": "The email custom details for the webinar reminder email, which goes out 24 hours before the event."
},
"default": {
"$ref": "#/components/schemas/webinar-email-content"
}
},
"description": "The email customization details for the webinar reminder email, which goes out 24 hours before the event.",
"x-konfig-properties": {
"default": {
"description": "The email default details for the webinar reminder email, which goes out 24 hours before the event."
}
}
},
"email_registration_confirmation": {
"type": "object",
"required": [
"custom",
"default"
],
"properties": {
"custom": {
"allOf": [
{
"$ref": "#/components/schemas/webinar-email-content"
}
],
"nullable": true,
"description": "The email custom details for the webinar registration confirmation email."
},
"default": {
"$ref": "#/components/schemas/webinar-email-content"
}
},
"description": "The email customization details for the webinar registration confirmation email.",
"x-konfig-properties": {
"default": {
"description": "The email default details for the webinar registration confirmation email."
}
}
}
}
}
webinar-event
{
"type": "object",
"title": "Webinar Event",
"required": [
"album",
"allow_share_link",
"allowed_privacies",
"auto_cc_enabled",
"auto_cc_keywords",
"auto_cc_language",
"auto_cc_remaining",
"automatically_title_stream",
"chat_enabled",
"completed_on",
"content_rating",
"created_time",
"dvr",
"email_quota",
"embed",
"from_showcase",
"head_clip",
"interaction_tools_settings",
"latency",
"lead_uuid",
"link",
"live_clips",
"live_destinations",
"low_latency",
"metadata",
"next_occurrence_time",
"parent_folder",
"pictures",
"playlist_sort",
"preferred_stream_method",
"rtmp_link",
"rtmp_preview",
"rtmps_link",
"schedule",
"scheduled_playback",
"status",
"stream_description",
"stream_key",
"stream_mode",
"stream_password",
"stream_privacy",
"stream_title",
"streamable_clip",
"time_zone",
"title",
"unlimited_auto_cc",
"unlimited_duration",
"uri",
"user",
"view_link",
"webinar",
"whitelisted_domains"
],
"properties": {
"dvr": {
"type": "boolean",
"example": true,
"description": "Whether the DVR feature is enabled."
},
"uri": {
"type": "string",
"example": "/webinars/events/h17vfa38-b561-4fc0-bgce-eb4d076gb52f",
"description": "The webinar event's canonical relative URI."
},
"link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo."
},
"user": {
"$ref": "#/components/schemas/user"
},
"album": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated showcase."
},
"embed": {
"type": "object",
"required": [
"airplay",
"autoplay",
"available_player_logos",
"byline",
"chat_embed_source",
"chromecast",
"closed_captions",
"color",
"colors",
"embed_chat",
"embed_properties",
"event_schedule",
"fullscreen_button",
"hide_live_label",
"hide_viewer_count",
"html",
"like_button",
"logos",
"loop",
"pip",
"play_button_position",
"playbar",
"playlist",
"portrait",
"responsive_html",
"schedule",
"show_latest_archived_clip",
"show_timezone",
"title",
"use_color",
"volume"
],
"properties": {
"pip": {
"type": "boolean",
"example": true,
"description": "Whether picture-in-picture is enabled and the button appears in the embeddable player."
},
"html": {
"type": "string",
"nullable": true,
"description": "The fixed HTML code to embed the event's playlist on a website."
},
"loop": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should loop back to the first video once content is exhausted."
},
"color": {
"type": "string",
"example": "#0a0808",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"logos": {
"type": "object",
"required": [
"custom",
"vimeo"
],
"properties": {
"vimeo": {
"type": "boolean",
"example": true,
"description": "Whether the Vimeo logo appears in the embeddable player for the video."
},
"custom": {
"type": "object",
"required": [
"active",
"link",
"sticky",
"url",
"use_link"
],
"properties": {
"url": {
"type": "string",
"example": "http://example.com",
"description": "The URL source of the custom player logo."
},
"link": {
"type": "string",
"example": "http://example.com",
"description": "The URL that loads upon clicking the custom logo."
},
"active": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears in the embeddable player."
},
"sticky": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo appears even when the player interface is hidden."
},
"use_link": {
"type": "boolean",
"example": true,
"description": "Whether the custom logo should use the URL link."
}
},
"description": "A collection of information relating to custom logos in the embeddable player."
}
},
"description": "A collection of information about the logo in the corner of the embeddable player."
},
"title": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the video title."
},
"byline": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's name."
},
"colors": {
"type": "object",
"required": [
"color_four",
"color_one",
"color_three",
"color_two"
],
"properties": {
"color_one": {
"type": "string",
"example": "#112233",
"description": "The first player color, which controls the color of the progress bar, buttons, and more."
},
"color_two": {
"type": "string",
"example": "#445566",
"description": "The second player color, which controls the player accent color."
},
"color_four": {
"type": "string",
"example": "#aabbcc",
"description": "The fourth player color, which controls the player background color."
},
"color_three": {
"type": "string",
"example": "#778899",
"description": "The third player color, which controls the color of text and icons."
}
},
"description": "A collection of information about player colors."
},
"volume": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the volume controls."
},
"airplay": {
"type": "boolean",
"example": true,
"description": "Whether AirPlay is enabled in the embeddable player."
},
"playbar": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the playbar."
},
"autoplay": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should autoplay the RLE content."
},
"playlist": {
"type": "boolean",
"example": true,
"description": "Whether the playlist component appears in the embeddable player for this RLE."
},
"portrait": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the author's portrait."
},
"schedule": {
"type": "boolean",
"example": true,
"description": "Whether the schedule component appears in the embeddable player for this RLE."
},
"use_color": {
"type": "string",
"example": "true",
"description": "Whether the embedded RLE player should use a custom color or the default Vimeo blue."
},
"chromecast": {
"type": "boolean",
"example": true,
"description": "Whether the Chromecast button appears in the embeddable player."
},
"embed_chat": {
"type": "string",
"nullable": true,
"description": "The embed code for RLE chat."
},
"like_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the `like` button."
},
"show_timezone": {
"type": "boolean",
"example": false,
"description": "Whether the embedded RLE player should display the schedule timezone."
},
"event_schedule": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the event schedule."
},
"closed_captions": {
"type": "boolean",
"example": true,
"description": "Whether closed captions are enabled in the embeddable player."
},
"hide_live_label": {
"type": "boolean",
"example": false,
"description": "Whether the Live label should be visible over the player."
},
"responsive_html": {
"type": "string",
"nullable": true,
"description": "The responsive HTML code to embed the event's playlist on a website."
},
"embed_properties": {
"type": "object",
"nullable": true,
"required": [
"height",
"source_url",
"width"
],
"properties": {
"width": {
"type": "string",
"description": "The width used to generate the fixed HTML embed code."
},
"height": {
"type": "string",
"description": "The height used to generate the fixed HTML embed code."
},
"source_url": {
"type": "string",
"description": "The source URL used to generate the fixed HTML embed code."
}
},
"description": "The height, width, and source URL properties used to generate the fixed HTML embed code."
},
"chat_embed_source": {
"type": "string",
"nullable": true,
"description": "The chat's iFrame source URL."
},
"fullscreen_button": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should include the fullscreen controls."
},
"hide_viewer_count": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should hide the viewer counter."
},
"play_button_position": {
"enum": [
0,
1,
2
],
"type": "integer",
"description": "The position of the player's play button.\n\nOption descriptions:\n * `0` - The play button has the default position.\n * `1` - The play button appears at the bottom of the interface.\n * `2` - The play button appears in the center of the interface.\n"
},
"available_player_logos": {
"type": "array",
"items": {
"type": "string"
},
"description": "The list of user-uploaded logos for configuration of the embed player."
},
"show_latest_archived_clip": {
"type": "boolean",
"example": true,
"description": "Whether the embedded RLE player should display the latest video placeholder."
}
},
"description": "The event's embed data."
},
"title": {
"type": "string",
"example": "Live Content",
"description": "The title of the event. This field is also optionally used as the base title for videos created by streaming to the event."
},
"status": {
"enum": [
"ended",
"started"
],
"type": "string",
"example": "started",
"nullable": true,
"description": "The status of the event.\n\nOption descriptions:\n * `ended` - The user ended the event.\n * `started` - The user started the event.\n"
},
"latency": {
"enum": [
"fail-safe",
"low",
"standard"
],
"type": "string",
"example": "standard",
"description": "The type of latency.\n\nOption descriptions:\n * `fail-safe` - The latency is in the failsafe range, with a delay of 60-75 seconds.\n * `low` - The latency is low, with a delay of 5-7 seconds.\n * `standard` - The latency is standard, with a delay of 15-20 seconds.\n"
},
"webinar": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "Information about the associated webinar."
},
"metadata": {
"type": "object",
"required": [
"connections",
"interactions"
],
"properties": {
"connections": {
"type": "object",
"required": [
"live_video",
"pictures",
"pre_live_video",
"team_member",
"videos"
],
"properties": {
"videos": {
"type": "object",
"required": [
"options",
"total",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos",
"description": "The API URI that resolves to the connection data."
},
"total": {
"type": "number",
"example": 6,
"description": "The total number of videos on this connection."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the videos that belong to the event."
},
"pictures": {
"type": "object",
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/pictures",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's thumbnails."
},
"live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"streaming"
],
"type": "string",
"example": "streaming",
"description": "The status of the live video's RTMP link.\n\nOption descriptions:\n * `streaming` - The stream is open and receiving content.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's live video, where applicable."
},
"team_member": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/users/123456789/team_users/123456",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the team member who owns the event."
},
"pre_live_video": {
"type": "object",
"nullable": true,
"required": [
"options",
"status",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/live_events/12345/videos/12345",
"description": "The API URI that resolves to the connection data."
},
"status": {
"enum": [
"pending",
"ready",
"streaming",
"unavailable"
],
"type": "string",
"example": "pending",
"description": "The status of the pre-live video's RTMP link.\n\nOption descriptions:\n * `pending` - Vimeo is working on setting up the connection.\n * `ready` - Resources have been provisioned for the event.\n * `streaming` - Live video is currently streaming to the RTMP link.\n * `unavailable` - The connection is ready, but streaming to the RTMP link has not yet begun.\n"
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of the HTTP methods permitted on this URI."
}
},
"description": "Information about the event's pre-live video, where applicable. A pre-live video is either activated or in the process of being activated."
}
},
"description": "A collection of information that is connected to this resource."
},
"interactions": {
"type": "object",
"required": [
"activate",
"delete",
"edit"
],
"properties": {
"edit": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to edit an item."
},
"delete": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to delete an item."
},
"activate": {
"type": "object",
"nullable": true,
"required": [
"options",
"uri"
],
"properties": {
"uri": {
"type": "string",
"description": "The API URI that resolves to the connection data."
},
"options": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of HTTP methods permitted on this URI."
}
},
"description": "Information about where and how to activate the event."
}
},
"description": "A list of resource URIs related to the event."
}
},
"description": "Metadata about the event."
},
"pictures": {
"$ref": "#/components/schemas/picture"
},
"schedule": {
"$ref": "#/components/schemas/live-event-schedule"
},
"head_clip": {
"type": "object",
"nullable": true,
"description": "The first video to be played in the playlist."
},
"lead_uuid": {
"type": "string",
"description": "The unique ID for the registered viewer."
},
"rtmp_link": {
"type": "string",
"example": "rtmp://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMP link. Send your live content to this link to create a live video on the event."
},
"time_zone": {
"type": "string",
"example": "America/New_York",
"description": "The time zone used in resolving the timestamps included in auto-generated video titles."
},
"view_link": {
"type": "string",
"example": "/events/12345",
"description": "The URI to access the event on Vimeo with or without an unlisted hash."
},
"live_clips": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of videos belonging to the event, including their video IDs and dates streamed."
},
"rtmps_link": {
"type": "string",
"example": "rtmps://rtmp.cloud.vimeo.com/live",
"nullable": true,
"description": "The upstream RTMPS link. Send your live content to this link to create a live video on the event."
},
"stream_key": {
"type": "string",
"example": "ab9c8def-7a65-4321-b098-c7dd65e43f21",
"nullable": true,
"description": "The stream key used in conjunction with the RTMP and RTMPS links."
},
"email_quota": {
"type": "object",
"required": [
"capping",
"total"
],
"properties": {
"total": {
"type": "number",
"example": 300,
"description": "The current number of entity emails that the user has sent."
},
"capping": {
"type": "number",
"example": 400,
"description": "The maximum number of entity emails that the user can send."
}
},
"description": "Information about the event owner's email quota."
},
"low_latency": {
"type": "boolean",
"example": false,
"description": "Whether the low-latency feature is enabled."
},
"stream_mode": {
"enum": [
"live",
"record",
"simulive"
],
"type": "string",
"example": "live",
"description": "The stream mode of the event.\n\nOption descriptions:\n * `live` - The stream is live playback.\n * `record` - The stream is in record mode.\n * `simulive` - The stream is scheduled media playback.\n"
},
"chat_enabled": {
"type": "boolean",
"example": true,
"description": "Whether to display live chat on the event page on Vimeo."
},
"completed_on": {
"type": "string",
"example": "2021-11-11T11:24:56+00:00",
"description": "The time in ISO 8601 format when the event was completed."
},
"created_time": {
"type": "string",
"example": "2016-11-03T09:24:56+00:00",
"description": "The time in ISO 8601 format when the event was created."
},
"from_webinar": {
"type": "boolean",
"description": "Whether the event was created from a webinar."
},
"rtmp_preview": {
"type": "boolean",
"example": true,
"description": "Whether to preview the RTMP stream before the event goes live."
},
"stream_title": {
"type": "string",
"example": "Special Feature",
"description": "The title of the next video streamed to the event. This field applies only when **automatically_title_stream** is `false`."
},
"from_showcase": {
"type": "boolean",
"description": "Whether the event was created from a showcase."
},
"parent_folder": {
"allOf": [
{
"$ref": "#/components/schemas/project"
}
],
"nullable": true,
"description": "Information about the folder that contains the event."
},
"playlist_sort": {
"enum": [
"added_first",
"added_last",
"alphabetical",
"arranged",
"comments",
"duration",
"likes",
"newest",
"oldest",
"plays"
],
"type": "string",
"example": "added_first",
"description": "The order in which the videos inside the event appear in the playlist.\n\nOption descriptions:\n * `added_first` - The videos appear according to when they were added to the event, with the most recently added first.\n * `added_last` - The videos appear according to when they were added to the event, with the most recently added last.\n * `alphabetical` - The videos appear alphabetically by their title.\n * `arranged` - The videos appear as arranged by the owner of the event.\n * `comments` - The videos appear according to their number of comments.\n * `duration` - The videos appear in order of duration.\n * `likes` - The videos appear according to their number of likes.\n * `newest` - The videos appear in chronological order, with the newest first.\n * `oldest` - The videos appear in chronological order, with the oldest first.\n * `plays` - The videos appear according to their number of plays.\n"
},
"content_rating": {
"enum": [
"advertisement",
"drugs",
"language",
"nudity",
"safe",
"unrated",
"violence"
],
"type": "array",
"items": {
"type": "string",
"example": "advertisement"
},
"description": "The event's granular content ratings.\n\nOption descriptions:\n * `advertisement` - The event contains advertisements.\n * `drugs` - The event contains drug or alcohol use.\n * `language` - The event contains profanity or sexually suggestive content.\n * `nudity` - The event contains nudity.\n * `safe` - The event is safe for all audiences.\n * `unrated` - The event hasn't been rated.\n * `violence` - The event contains violence.\n"
},
"stream_privacy": {
"type": "object",
"required": [
"embed",
"unlisted_hash",
"view"
],
"properties": {
"view": {
"enum": [
"anybody",
"embed_only",
"nobody",
"password",
"unlisted"
],
"type": "string",
"example": "anybody",
"description": "The general privacy setting for generated videos and the embed privacy of the entire collection.\n\nOption descriptions:\n * `anybody` - Anyone can access the videos. This privacy setting appears as `Public` on the Vimeo front end.\n * `embed_only` - The videos don't appear on Vimeo, but they can be embedded elsewhere.\n * `nobody` - Only the event owner can access the videos. This privacy setting appears as `Private` on the Vimeo front end.\n * `password` - Only those with the password can access the videos.\n * `unlisted` - Only those with the private link can access the videos.\n"
},
"embed": {
"enum": [
"private",
"public",
"whitelist"
],
"type": "string",
"example": "public",
"description": "The event's embed permission setting.\n\nOption descriptions:\n * `private` - The event can't be embedded on any domain.\n * `public` - The event can be embedded on any domain.\n * `whitelist` - The event can be embedded on whitelisted domains only.\n"
},
"unlisted_hash": {
"type": "string",
"example": "1a2b3c4d5e",
"nullable": true,
"description": "The hash for unlisted events."
}
},
"description": "The initial privacy settings of videos generated by streaming to the event as well as the embed privacy of the entire collection."
},
"auto_cc_enabled": {
"type": "boolean",
"nullable": true,
"description": "Whether the automated closed captions feature is enabled."
},
"stream_password": {
"type": "string",
"example": "hunter1",
"nullable": true,
"description": "The password that anyone can use to access the videos generated by streaming to the event."
},
"streamable_clip": {
"type": "object",
"nullable": true,
"description": "The event's video. An event always has a video, which is either in a pre-live state (ready to be streamed to) or in a live state (which is currently being streamed to)."
},
"allow_share_link": {
"type": "boolean",
"example": true,
"description": "Whether the share link for the videos generated by streaming to the event is usable."
},
"auto_cc_keywords": {
"type": "string",
"nullable": true,
"description": "A comma-separated list of keywords for enhancing the speech detection of automated closed captions."
},
"auto_cc_language": {
"enum": [
"de-DE",
"en-US",
"es-ES",
"fr-FR",
"pt-BR"
],
"type": "string",
"example": "en-US",
"nullable": true,
"description": "The language of the automated closed captions.\n\nOption descriptions:\n * `de-DE` - The language is German.\n * `en-US` - The language is English.\n * `es-ES` - The language is Spanish.\n * `fr-FR` - The language is French.\n * `pt-BR` - The language is Portuguese.\n"
},
"allowed_privacies": {
"type": "array",
"items": {
"type": "string"
},
"description": "An array of privacy settings supported for this event and the requesting user."
},
"auto_cc_remaining": {
"type": "number",
"nullable": true,
"description": "The amount of time remaining to the user to access the automated closed captions feature."
},
"live_destinations": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "_This field is deprecated in favor of the following method:_ [Get all the destinations of a one-time live event](https://developer.vimeo.com/api/reference/live#get_one_time_event_destinations)."
},
"unlimited_auto_cc": {
"type": "boolean",
"nullable": true,
"description": "Whether to ignore the time limit of the automated closed captions feature."
},
"scheduled_playback": {
"type": "boolean",
"example": false,
"description": "Whether the scheduled playback feature is enabled."
},
"stream_description": {
"type": "string",
"example": "In this episode, we interview a surprise guest",
"nullable": true,
"description": "The description of the next video streamed to the event."
},
"unlimited_duration": {
"type": "boolean",
"example": true,
"description": "Whether 24/7 streaming is enabled for the event."
},
"whitelisted_domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"allow_hd",
"domain",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/videos/258684937/privacy/domains/example.com",
"description": "The URI of the domain."
},
"domain": {
"type": "string",
"example": "example.com",
"description": "The domain name."
},
"allow_hd": {
"type": "boolean",
"example": true,
"description": "Whether to permit HD embeds on this domain."
}
}
},
"nullable": true,
"description": "The domains on a video's whitelist."
},
"next_occurrence_time": {
"type": "string",
"example": "2018-07-30T14:00:00+00:00",
"nullable": true,
"description": "The date in ISO 8601 format on which the next occurrence of the event is expected to be live."
},
"preferred_stream_method": {
"enum": [
"browser",
"encoder"
],
"type": "string",
"example": "encoder",
"description": "The preferred streaming method.\n\nOption descriptions:\n * `browser` - Stream in the browser.\n * `encoder` - Stream by the encoder.\n"
},
"automatically_title_stream": {
"type": "boolean",
"example": true,
"description": "When the value of this field is `true`, the title for the next video in the event is generated based on the time of the stream and the **title** field of the event."
},
"interaction_tools_settings": {
"type": "array",
"items": {
"type": "object",
"required": [
"is_anonymous_questions_disabled",
"is_qna_moderated"
],
"properties": {
"is_qna_moderated": {
"type": "boolean",
"description": "Whether the Q&A is moderated for the interaction tools settings."
},
"is_anonymous_questions_disabled": {
"type": "boolean",
"description": "Whether anonymous questions are disabled for the interaction tools settings."
}
}
},
"nullable": true,
"description": "The settings for the interaction tools."
}
},
"x-konfig-properties": {
"user": {
"description": "The owner of the event."
},
"pictures": {
"description": "The active thumbnail image of the event."
},
"schedule": {
"description": "The description of the time or times that the event is expected to be live."
}
}
}
webinar-registrant
{
"type": "object",
"title": "Webinar Registrant",
"required": [
"analytics",
"created_on",
"data",
"email",
"first_name",
"has_attended",
"is_blocked",
"last_name",
"referrer",
"source_details",
"source_type",
"uri"
],
"properties": {
"uri": {
"type": "string",
"example": "/webinars/db1d0719b52f-bfce-4f20-b266-f19bfa08/registrants/f19bfa08-b266-4f20-bfce-db1d0719b52f",
"description": "The API URL to return the webinar registrant's account."
},
"data": {
"type": "object",
"example": "{'Company':'Vimeo'}",
"nullable": true,
"description": "The values of all other fields as submitted on the webinar registration form."
},
"email": {
"type": "string",
"example": "jane.doe@vimeo.com",
"description": "The registrant's email address as submitted on the webinar registration form."
},
"referrer": {
"type": "string",
"example": "http://example.com",
"nullable": true,
"description": "The web address where the registration form was submitted."
},
"analytics": {
"type": "object",
"required": [
"view_percentage"
],
"properties": {
"view_percentage": {
"type": "number",
"description": "The percentage of the total webinar that the webinar registrant has attended."
}
},
"description": "The analytics data container for the webinar registrant."
},
"last_name": {
"type": "string",
"example": "Doe",
"nullable": true,
"description": "The registrant's last name as submitted on the webinar registration form."
},
"created_on": {
"type": "number",
"example": 1620053300000,
"description": "The date in Unix time when the registrant's account was created."
},
"first_name": {
"type": "string",
"example": "Jane",
"nullable": true,
"description": "The registrant's first name as submitted on the webinar registration form."
},
"is_blocked": {
"type": "boolean",
"example": false,
"description": "Whether the registrant's viewing status for the webinar is blocked."
},
"source_type": {
"type": "string",
"example": "CSV",
"nullable": true,
"description": "The source from which the registrant's account was created."
},
"has_attended": {
"enum": [
"B",
"N",
"Y"
],
"type": "string",
"example": "B",
"description": "The registrant's attended status for the webinar.\n\nOption descriptions:\n * `B` - The registrant has been blocked from attending the webinar.\n * `N` - The registrant has not attended the webinar.\n * `Y` - The registrant has attended the webinar.\n"
},
"source_details": {
"type": "object",
"nullable": true,
"description": "Details about the source from which the registrant's account was created."
}
}
}