---
title: "Changes to Create a video"
method: POST
path: "/v1/videos"
---

# Changes to Create a video

`POST /v1/videos`

> Every recorded change to this operation, newest first.
> 65 revisions in range; 1 not diffed.

## Timeline

Changed in 15 of 65 revisions.

- **2026-11-07** `0cc3fcd307ad`: 2 breaking, 6 info
- **2026-10-30** `0b2b8234a7db`: 10 info
- **2026-10-28** `d74197bff4c4`: 1 info
- **2026-10-22** `be1566e2502f`: 7 info
- **2026-10-22** `063dd2193962`: 6 warning, 6 info
- **2026-10-19** `ebdc52a2e735`: 2 info
- **2026-10-15** `a77588e1cfb4`: 2 info
- **2026-10-11** `57612a6f581b`: 4 info
- **2026-09-29** `704d6fc3bc60`: 4 info
- **2026-09-28** `ac47c99c144f`: 9 warning
- **2026-09-21** `e70780c11bde`: 8 info
- **2026-09-12** `955068d95b7e`: 96 info
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info
- **2026-09-03** `841897ed76ba`: 1 info
- **2026-09-02** `cd69045c703a`: 2 info

## Changes

- **2026-11-07** `0cc3fcd307ad`: 2 breaking, 6 info
  - the `dimensions/height` request property's max was decreased to `1920.00`
  - the `dimensions/width` request property's max was decreased to `1920.00`
  - added the new optional request property `creatorEnabled`
  - added the new optional request property `eyeContact`
  - added the new optional request property `keystrokes/allOf[#/components/schemas/KeystrokeSettingsUpdate]/typing`
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/eyeContact` to the response with the `201` status
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/keystrokes/allOf[#/components/schemas/KeystrokeSettings]/typing` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/creatorEnabled` to the response with the `201` status
- **2026-10-30** `0b2b8234a7db`: 10 info
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/backgroundPadding`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/backgroundPadding`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/backgroundPadding`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/backgroundPadding`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #5: Classic]/backgroundPadding`
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/captionStyle/oneOf[subschema #1: Backdrop]/backgroundPadding` to the response with the `201` status
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/captionStyle/oneOf[subschema #2: Highlight]/backgroundPadding` to the response with the `201` status
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/captionStyle/oneOf[subschema #3: Mono]/backgroundPadding` to the response with the `201` status
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/captionStyle/oneOf[subschema #4: Cannes]/backgroundPadding` to the response with the `201` status
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/captionStyle/oneOf[subschema #5: Classic]/backgroundPadding` to the response with the `201` status
- **2026-10-28** `d74197bff4c4`: 1 info
  - the request property `sourceId` became optional
- **2026-10-22** `be1566e2502f`: 7 info
  - added the new optional request property `keystrokes`
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/keystrokes` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/callToAction` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/callToActionsHidden` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/secondaryCallToAction` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/workspaceCallToAction` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/workspaceSecondaryCallToAction` to the response with the `201` status
- **2026-10-22** `063dd2193962`: 6 warning, 6 info
  - added the new `focused` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/layoutAnimationStyle` response property for the response status `201`
  - added the new `focused` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/zoomAnimationStyle` response property for the response status `201`
  - added the new `punchy` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/layoutAnimationStyle` response property for the response status `201`
  - added the new `punchy` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/zoomAnimationStyle` response property for the response status `201`
  - added the new `smooth` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/layoutAnimationStyle` response property for the response status `201`
  - added the new `smooth` enum value to the `video/settings/allOf[#/components/schemas/VideoSettings]/zoomAnimationStyle` response property for the response status `201`
  - added the new `focused` enum value to the request property `layoutAnimationStyle`
  - added the new `focused` enum value to the request property `zoomAnimationStyle`
  - added the new `punchy` enum value to the request property `layoutAnimationStyle`
  - added the new `punchy` enum value to the request property `zoomAnimationStyle`
  - added the new `smooth` enum value to the request property `layoutAnimationStyle`
  - added the new `smooth` enum value to the request property `zoomAnimationStyle`
- **2026-10-19** `ebdc52a2e735`: 2 info
  - added the new optional request property `motionBlurAmount`
  - added the optional property `video/settings/allOf[#/components/schemas/VideoSettings]/motionBlurAmount` to the response with the `201` status
- **2026-10-15** `a77588e1cfb4`: 2 info
  - added the new optional request property `studioSoundLevel`
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/studioSoundLevel` to the response with the `201` status
- **2026-10-11** `57612a6f581b`: 4 info
  - added the new optional request property `cursor/allOf[#/components/schemas/CursorSettingsUpdate]/tilt`
  - added the new optional request property `cursor/allOf[#/components/schemas/CursorSettingsUpdate]/tiltStrength`
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/cursor/tilt` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/cursor/tiltStrength` to the response with the `201` status
- **2026-09-29** `704d6fc3bc60`: 4 info
  - added the new optional request property `layoutAnimationStyle`
  - added the new optional request property `zoomAnimationStyle`
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/layoutAnimationStyle` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/zoomAnimationStyle` to the response with the `201` status
- **2026-09-28** `ac47c99c144f`: 9 warning
  - added the new `edit_conflict` enum value to the `error` response property for the response status `400`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `401`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `403`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `404`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `409`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `429`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `500`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `501`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `503`
- **2026-09-21** `e70780c11bde`: 8 info
  - added the new optional request property `captionFontFamily`
  - added the new optional request property `captionFontSize`
  - added the new optional request property `captionFontWeight`
  - added the new optional request property `captionLinesPerBlock`
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/captionFontFamily` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/captionFontSize` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/captionFontWeight` to the response with the `201` status
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/captionLinesPerBlock` to the response with the `201` status
- **2026-09-12** `955068d95b7e`: 96 info
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/activeWordTextColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/backgroundEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/highlightColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/highlightMode`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/outlineColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/outlineEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/shadowColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/shadowEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #1: Backdrop]/textCase`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/backgroundColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/backgroundEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/highlightMode`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/outlineColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/outlineEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/shadowColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/shadowEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/textCase`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #2: Highlight]/wordLevelHighlights`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/activeWordTextColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/backgroundColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/backgroundEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/highlightMode`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/outlineColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/outlineEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/shadowColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/shadowEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/textCase`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #3: Mono]/wordLevelHighlights`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/activeWordTextColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/backgroundColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/backgroundEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/highlightColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/highlightMode`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/outlineColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/outlineEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/shadowEnabled`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/textCase`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #4: Cannes]/wordLevelHighlights`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #5: Classic]/activeWordTextColor`
  - added the new optional request property `captionStyle/allOf[#/components/schemas/CaptionStyle]/oneOf[subschema #5: Classic]/backgroundColor`
  - …56 more
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info
  - added the new `conflict` enum value to the `error` response property for the response status `400`
  - added the new `conflict` enum value to the `error` response property for the response status `401`
  - added the new `conflict` enum value to the `error` response property for the response status `403`
  - added the new `conflict` enum value to the `error` response property for the response status `404`
  - added the new `conflict` enum value to the `error` response property for the response status `429`
  - added the new `conflict` enum value to the `error` response property for the response status `500`
  - added the new `conflict` enum value to the `error` response property for the response status `501`
  - added the new `unavailable` enum value to the `error` response property for the response status `400`
  - added the new `unavailable` enum value to the `error` response property for the response status `401`
  - added the new `unavailable` enum value to the `error` response property for the response status `403`
  - added the new `unavailable` enum value to the `error` response property for the response status `404`
  - added the new `unavailable` enum value to the `error` response property for the response status `429`
  - added the new `unavailable` enum value to the `error` response property for the response status `500`
  - added the new `unavailable` enum value to the `error` response property for the response status `501`
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
- **2026-09-03** `841897ed76ba`: 1 info
  - added the required property `video/settings/allOf[#/components/schemas/VideoSettings]/thumbnailInpointMs` to the response with the `201` status
- **2026-09-02** `cd69045c703a`: 2 info
  - added the new optional request property `autoRatio`
  - added the required property `video/autoRatio` to the response with the `201` status

---

[Operation](https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/post.md) - [API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [Page](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/post)
