From 7347e2057f3e0b9480bb9e7cac91c3b4a612b0ce Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 11 Aug 2026 09:55:34 +0000 Subject: [PATCH] feat: Updated OpenAPI spec --- .../Generated/Shotstack.Models.Asset.g.cs | 6 +++-- .../Generated/Shotstack.Models.HtmlAsset.g.cs | 2 +- .../Shotstack.Models.Soundtrack.g.cs | 5 ++++ .../Generated/Shotstack.Models.TextAsset.g.cs | 25 ++++++++++--------- .../Generated/Shotstack.Models.Timeline.g.cs | 9 +++---- .../Shotstack.Models.TitleAsset.g.cs | 2 +- src/libs/Shotstack/openapi.json | 13 ++++++---- 7 files changed, 36 insertions(+), 26 deletions(-) diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.Asset.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.Asset.g.cs index 430501f..54da7f7 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.Asset.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.Asset.g.cs @@ -101,6 +101,8 @@ public bool TryPickImage( : throw new global::System.InvalidOperationException($"Expected union variant 'Image' but the value was {ToString()}."); /// + /// **Notice: The TextAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.** This type
+ /// continues to function; no behaviour change for existing integrations.
/// The TextAsset is used to add text and titles to a video. The text can be styled with built in and custom
/// [Fonts](#tocs_font). You can also add a background bounding box used to control wrapping and overflow. Emoticons are also supported. ///
@@ -342,7 +344,7 @@ public bool TryPickRichCaption( : throw new global::System.InvalidOperationException($"Expected union variant 'RichCaption' but the value was {ToString()}."); /// - /// **Notice: The HtmlAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**
+ /// **Notice: The HtmlAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**
/// The HtmlAsset clip type lets you create text based layout and formatting using
/// HTML and CSS. You can also set the height and width of a bounding box for the HTML
/// content to sit within. Text and elements will wrap within the bounding box. @@ -419,7 +421,7 @@ public bool TryPickHtml5( : throw new global::System.InvalidOperationException($"Expected union variant 'Html5' but the value was {ToString()}."); /// - /// **Notice: The TitleAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**
+ /// **Notice: The TitleAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**
/// The TitleAsset clip type lets you create video titles from a text string and apply styling and positioning. ///
#if NET6_0_OR_GREATER diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.HtmlAsset.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.HtmlAsset.g.cs index ebd13ea..fa76e43 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.HtmlAsset.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.HtmlAsset.g.cs @@ -4,7 +4,7 @@ namespace Shotstack { /// - /// **Notice: The HtmlAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**
+ /// **Notice: The HtmlAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**
/// The HtmlAsset clip type lets you create text based layout and formatting using
/// HTML and CSS. You can also set the height and width of a bounding box for the HTML
/// content to sit within. Text and elements will wrap within the bounding box. diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.Soundtrack.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.Soundtrack.g.cs index b46a2a3..792e25c 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.Soundtrack.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.Soundtrack.g.cs @@ -4,8 +4,10 @@ namespace Shotstack { /// + /// **Notice: The Soundtrack is deprecated, use an [AudioAsset](#tocs_audioasset) clip on its own track instead.** This type continues to function; no behaviour change for existing integrations.
/// A music or audio file in mp3 format that plays for the duration of the rendered video or the length of the audio file, which ever is shortest. ///
+ [global::System.Obsolete("This model marked as deprecated.")] public sealed partial class Soundtrack { /// @@ -15,6 +17,7 @@ public sealed partial class Soundtrack /// https://s3-ap-northeast-1.amazonaws.com/my-bucket/music.mp3 [global::System.Text.Json.Serialization.JsonPropertyName("src")] [global::System.Text.Json.Serialization.JsonRequired] + [global::System.Obsolete("This property marked as deprecated.")] public required string Src { get; set; } /// @@ -26,12 +29,14 @@ public sealed partial class Soundtrack /// [global::System.Text.Json.Serialization.JsonPropertyName("effect")] [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Shotstack.JsonConverters.SoundtrackEffectJsonConverter))] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.SoundtrackEffect? Effect { get; set; } /// /// Set the volume for the soundtrack between 0 and 1 where 0 is muted and 1 is full volume (defaults to 1). /// [global::System.Text.Json.Serialization.JsonPropertyName("volume")] + [global::System.Obsolete("This property marked as deprecated.")] public double? Volume { get; set; } /// diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.TextAsset.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.TextAsset.g.cs index 10afa9d..c91ea3e 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.TextAsset.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.TextAsset.g.cs @@ -4,9 +4,12 @@ namespace Shotstack { /// + /// **Notice: The TextAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.** This type
+ /// continues to function; no behaviour change for existing integrations.
/// The TextAsset is used to add text and titles to a video. The text can be styled with built in and custom
/// [Fonts](#tocs_font). You can also add a background bounding box used to control wrapping and overflow. Emoticons are also supported. ///
+ [global::System.Obsolete("This model marked as deprecated.")] public sealed partial class TextAsset { /// @@ -16,6 +19,7 @@ public sealed partial class TextAsset /// global::Shotstack.TextAssetType.Text [global::System.Text.Json.Serialization.JsonPropertyName("type")] [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Shotstack.JsonConverters.TextAssetTypeJsonConverter))] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextAssetType Type { get; set; } = global::Shotstack.TextAssetType.Text; /// @@ -25,6 +29,7 @@ public sealed partial class TextAsset /// Hello World [global::System.Text.Json.Serialization.JsonPropertyName("text")] [global::System.Text.Json.Serialization.JsonRequired] + [global::System.Obsolete("This property marked as deprecated.")] public required string Text { get; set; } /// @@ -33,6 +38,7 @@ public sealed partial class TextAsset /// /// 400 [global::System.Text.Json.Serialization.JsonPropertyName("width")] + [global::System.Obsolete("This property marked as deprecated.")] public int? Width { get; set; } /// @@ -41,36 +47,42 @@ public sealed partial class TextAsset /// /// 200 [global::System.Text.Json.Serialization.JsonPropertyName("height")] + [global::System.Obsolete("This property marked as deprecated.")] public int? Height { get; set; } /// /// Font properties for text. /// [global::System.Text.Json.Serialization.JsonPropertyName("font")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextFont? Font { get; set; } /// /// Displays a background box behind the text. /// [global::System.Text.Json.Serialization.JsonPropertyName("background")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextBackground? Background { get; set; } /// /// Horizontal and vertical alignment properties for text. /// [global::System.Text.Json.Serialization.JsonPropertyName("alignment")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextAlignment? Alignment { get; set; } /// /// Text stroke (outline) properties. /// [global::System.Text.Json.Serialization.JsonPropertyName("stroke")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextStroke? Stroke { get; set; } /// /// Animation properties for text entrance effects. /// [global::System.Text.Json.Serialization.JsonPropertyName("animation")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.TextAnimation? Animation { get; set; } /// @@ -79,6 +91,7 @@ public sealed partial class TextAsset /// /// ... [global::System.Text.Json.Serialization.JsonPropertyName("ellipsis")] + [global::System.Obsolete("This property marked as deprecated.")] public string? Ellipsis { get; set; } /// @@ -159,17 +172,5 @@ public TextAsset() { } - /// - /// Creates a new from its single non-const required field, - /// hardcoding any const discriminator fields. - /// - public static TextAsset FromText(string text) - { - return new TextAsset - { - Text = text, - }; - } - } } \ No newline at end of file diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.Timeline.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.Timeline.g.cs index d93d0f9..afb5b41 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.Timeline.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.Timeline.g.cs @@ -1,4 +1,6 @@ +#pragma warning disable CS0618 // Type or member is obsolete + #nullable enable namespace Shotstack @@ -9,9 +11,11 @@ namespace Shotstack public sealed partial class Timeline { /// + /// **Notice: The Soundtrack is deprecated, use an [AudioAsset](#tocs_audioasset) clip on its own track instead.** This type continues to function; no behaviour change for existing integrations.
/// A music or audio file in mp3 format that plays for the duration of the rendered video or the length of the audio file, which ever is shortest. ///
[global::System.Text.Json.Serialization.JsonPropertyName("soundtrack")] + [global::System.Obsolete("This property marked as deprecated.")] public global::Shotstack.Soundtrack? Soundtrack { get; set; } /// @@ -51,9 +55,6 @@ public sealed partial class Timeline /// /// A timeline consists of an array of tracks, each track containing clips. Tracks are layered on top of each other in the same order they are added to the array with the top most track layered over the top of those below it. Ensure that a track containing titles is the top most track so that it is displayed above videos and images. /// - /// - /// A music or audio file in mp3 format that plays for the duration of the rendered video or the length of the audio file, which ever is shortest. - /// /// /// A hexadecimal value for the timeline background colour. Defaults to #000000 (black). /// @@ -68,12 +69,10 @@ public sealed partial class Timeline #endif public Timeline( global::System.Collections.Generic.IList tracks, - global::Shotstack.Soundtrack? soundtrack, string? background, global::System.Collections.Generic.IList? fonts, bool? cache) { - this.Soundtrack = soundtrack; this.Background = background; this.Fonts = fonts; this.Tracks = tracks ?? throw new global::System.ArgumentNullException(nameof(tracks)); diff --git a/src/libs/Shotstack/Generated/Shotstack.Models.TitleAsset.g.cs b/src/libs/Shotstack/Generated/Shotstack.Models.TitleAsset.g.cs index fe18474..0c539b5 100644 --- a/src/libs/Shotstack/Generated/Shotstack.Models.TitleAsset.g.cs +++ b/src/libs/Shotstack/Generated/Shotstack.Models.TitleAsset.g.cs @@ -4,7 +4,7 @@ namespace Shotstack { /// - /// **Notice: The TitleAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**
+ /// **Notice: The TitleAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**
/// The TitleAsset clip type lets you create video titles from a text string and apply styling and positioning. ///
[global::System.Obsolete("This model marked as deprecated.")] diff --git a/src/libs/Shotstack/openapi.json b/src/libs/Shotstack/openapi.json index c827bf4..1d63488 100644 --- a/src/libs/Shotstack/openapi.json +++ b/src/libs/Shotstack/openapi.json @@ -791,7 +791,8 @@ "description": "A timeline represents the contents of a video edit over time, an audio edit over time, in seconds, or an image layout. A timeline consists of layers called tracks. Tracks are composed of titles, images, audio, html or video segments referred to as clips which are placed along the track at specific starting point and lasting for a specific amount of time.", "properties": { "soundtrack": { - "description": "A music or audio soundtrack file in mp3 format.", + "deprecated": true, + "description": "A music or audio soundtrack file in mp3 format. Deprecated - use an [AudioAsset](#tocs_audioasset) clip on its own track instead.", "$ref": "#/components/schemas/Soundtrack" }, "background": { @@ -825,7 +826,8 @@ "type": "object" }, "Soundtrack": { - "description": "A music or audio file in mp3 format that plays for the duration of the rendered video or the length of the audio file, which ever is shortest.", + "deprecated": true, + "description": "**Notice: The Soundtrack is deprecated, use an [AudioAsset](#tocs_audioasset) clip on its own track instead.** This type continues to function; no behaviour change for existing integrations.\nA music or audio file in mp3 format that plays for the duration of the rendered video or the length of the audio file, which ever is shortest.", "properties": { "src": { "description": "The URL of the mp3 audio file. The URL must be publicly accessible or include credentials.", @@ -1360,7 +1362,8 @@ ] }, "TextAsset": { - "description": "The TextAsset is used to add text and titles to a video. The text can be styled with built in and custom\n[Fonts](#tocs_font). You can also add a background bounding box used to control wrapping and overflow. Emoticons are also supported.\n", + "deprecated": true, + "description": "**Notice: The TextAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.** This type\ncontinues to function; no behaviour change for existing integrations.\n\nThe TextAsset is used to add text and titles to a video. The text can be styled with built in and custom\n[Fonts](#tocs_font). You can also add a background bounding box used to control wrapping and overflow. Emoticons are also supported.\n", "type": "object", "properties": { "type": { @@ -2199,7 +2202,7 @@ }, "HtmlAsset": { "deprecated": true, - "description": "**Notice: The HtmlAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**\n\nThe HtmlAsset clip type lets you create text based layout and formatting using\nHTML and CSS. You can also set the height and width of a bounding box for the HTML\ncontent to sit within. Text and elements will wrap within the bounding box.\n", + "description": "**Notice: The HtmlAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**\n\nThe HtmlAsset clip type lets you create text based layout and formatting using\nHTML and CSS. You can also set the height and width of a bounding box for the HTML\ncontent to sit within. Text and elements will wrap within the bounding box.\n", "type": "object", "properties": { "type": { @@ -2295,7 +2298,7 @@ }, "TitleAsset": { "deprecated": true, - "description": "**Notice: The TitleAsset is deprecated, use the [TextAsset](#tocs_textasset) instead.**\n\nThe TitleAsset clip type lets you create video titles from a text string and apply styling and positioning.\n", + "description": "**Notice: The TitleAsset is deprecated, use the [RichTextAsset](#tocs_richtextasset) instead.**\n\nThe TitleAsset clip type lets you create video titles from a text string and apply styling and positioning.\n", "type": "object", "properties": { "type": {