ittybit 0.7.5.2 → 0.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd94f84a429123a0617b4f00a5bffd27d702caff501b14315b2003fa3bdf1dab
-  data.tar.gz: 8fda5aa3693a6d3e4595337edfd2dd2c292d4d70cd535a00c7b72b6ce931a35b
+  metadata.gz: b244efadc944c3d3983943a53e62e0b553e21eb9e0717ff4a3ee1512f3879909
+  data.tar.gz: f3736a908e119ee1324f616e07af8f63e4fdd5f0ac4447b6440990ece8fd7629
 SHA512:
-  metadata.gz: 68e625decf459f5b295630c5b4dac821959a45854d3349967550a296f781d84f516dceff5dd84e784072ee36a19731161566ddd5ce6a76a33bb02568eebc51b3
-  data.tar.gz: 5e14eae95e7e3c0e5ec81935d3a4591872d134f05b3430bdec49e11f3b857bed16735a61e46b435b76629f9b2034bc4ed091993dbc93c117bf3c2fe62f507a00
+  metadata.gz: 50e7da1d6cfb20932674642060b296ac71aedc88cb7ff4fa821ce18775458168afb227792f3605b601dccd370b15943e136ddd7f2fed98fe70a900ead5b1215c
+  data.tar.gz: c3038600b9d3973c045e1a7efa2e789bb15ba17b3ea3e5cab7b7681798634eb7d5c4c9b822d417599c6e034ed8a5e28affa1c29ee3779974ec45c8f48720b097

data/lib/ittybit/automations/client.rb

@@ -126,12 +126,16 @@ module Ittybit
     #   * :conditions (Array<Ittybit::Automations::AutomationsUpdateRequestTriggerConditionsItem>)
     # @param workflow [Array<Hash>] The updated sequence of tasks for the automation.Request of type Array<Ittybit::WorkflowTaskStep>, as a Hash
     #   * :kind (Ittybit::WorkflowTaskStepKind)
-    #   * :label (String)
+    #   * :ref (String)
     #   * :format (String)
+    #   * :start (Float)
+    #   * :end_ (Float)
     #   * :width (Integer)
     #   * :height (Integer)
-    #   * :resize (String)
+    #   * :fit (String)
+    #   * :background (String)
     #   * :quality (Integer)
+    #   * :next_ (Array<Object>)
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::AutomationResponse]
     # @example
@@ -144,7 +148,7 @@ module Ittybit
     #    id: "id",
     #    name: "Updated Transcoder Example",
     #    trigger: { event: "upload.completed", conditions: [{ prop: "file.type", value: "image/*" }] },
-    #    workflow: [{ kind: IMAGE, label: "archive_image", format: "webp" }]
+    #    workflow: [{ kind: IMAGE, format: "webp" }]
     #  )
     def update(id:, name:, description: nil, trigger: nil, workflow: nil, request_options: nil)
       response = @request_client.conn.put do |req|
@@ -328,12 +332,16 @@ module Ittybit
     #   * :conditions (Array<Ittybit::Automations::AutomationsUpdateRequestTriggerConditionsItem>)
     # @param workflow [Array<Hash>] The updated sequence of tasks for the automation.Request of type Array<Ittybit::WorkflowTaskStep>, as a Hash
     #   * :kind (Ittybit::WorkflowTaskStepKind)
-    #   * :label (String)
+    #   * :ref (String)
     #   * :format (String)
+    #   * :start (Float)
+    #   * :end_ (Float)
     #   * :width (Integer)
     #   * :height (Integer)
-    #   * :resize (String)
+    #   * :fit (String)
+    #   * :background (String)
     #   * :quality (Integer)
+    #   * :next_ (Array<Object>)
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::AutomationResponse]
     # @example
@@ -346,7 +354,7 @@ module Ittybit
     #    id: "id",
     #    name: "Updated Transcoder Example",
     #    trigger: { event: "upload.completed", conditions: [{ prop: "file.type", value: "image/*" }] },
-    #    workflow: [{ kind: IMAGE, label: "archive_image", format: "webp" }]
+    #    workflow: [{ kind: IMAGE, format: "webp" }]
     #  )
     def update(id:, name:, description: nil, trigger: nil, workflow: nil, request_options: nil)
       Async do

data/lib/ittybit/files/client.rb

@@ -3,7 +3,7 @@
 require_relative "../../requests"
 require_relative "../types/file_list_response"
 require_relative "../types/file_response"
-require_relative "types/files_delete_response"
+require_relative "../types/confirmation_response"
 require "async"
 
 module Ittybit
@@ -18,9 +18,8 @@ module Ittybit
     end
 
     # Retrieves a paginated list of all files associated with the current project.
-    #  Files can be filtered using query parameters.
     #
-    # @param limit [Integer] Items per page
+    # @param limit [Integer]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileListResponse]
     # @example
@@ -49,16 +48,14 @@ module Ittybit
       Ittybit::FileListResponse.from_json(json_object: response.body)
     end
 
-    # Registers a file from a publicly accessible URL. The file will be ingested
-    #  asynchronously.
+    # Creates a new file from a publicly accessible or signed URL.
     #
-    # @param url [String] The publicly accessible URL of the file to ingest.
-    # @param filename [String] Optional desired filename. If not provided, it may be derived from the URL.
-    # @param folder [String] Folder path (optional)
-    # @param media_id [String] Optional existing media ID to associate the file with.
-    # @param label [String] Optional label for the file.
-    # @param metadata [Hash{String => Object}] Optional user-defined key-value metadata.
-    # @param async [Boolean] Whether to process the ingestion asynchronously.
+    # @param url [String]
+    # @param media_id [String]
+    # @param folder [String]
+    # @param filename [String]
+    # @param ref [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileResponse]
     # @example
@@ -68,13 +65,12 @@ module Ittybit
     #    token: "YOUR_AUTH_TOKEN"
     #  )
     #  api.files.create(
-    #    url: "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
-    #    filename: "bunny.mp4",
-    #    folder: "examples/cartoons",
-    #    metadata: { "credit": "gtv-videos-bucket" }
+    #    url: "https://ittyb.it/sample.mp4",
+    #    folder: "ittybit/samples",
+    #    filename: "video.mp4",
+    #    metadata: { "customKey2": "a different custom value" }
     #  )
-    def create(url:, filename: nil, folder: nil, media_id: nil, label: nil, metadata: nil, async: nil,
-               request_options: nil)
+    def create(url:, media_id: nil, folder: nil, filename: nil, ref: nil, metadata: nil, request_options: nil)
       response = @request_client.conn.post do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
@@ -90,20 +86,18 @@ module Ittybit
         req.body = {
           **(request_options&.additional_body_parameters || {}),
           url: url,
-          filename: filename,
-          folder: folder,
           media_id: media_id,
-          label: label,
-          metadata: metadata,
-          async: async
+          folder: folder,
+          filename: filename,
+          ref: ref,
+          metadata: metadata
         }.compact
         req.url "#{@request_client.get_url(request_options: request_options)}/files"
       end
       Ittybit::FileResponse.from_json(json_object: response.body)
     end
 
-    # Retrieves detailed information about a specific file identified by its unique
-    #  ID, including its metadata, media associations, and technical properties.
+    # Retrieve the file object for a file with the given ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -137,11 +131,10 @@ module Ittybit
     end
 
     # Permanently removes a file from the system. This action cannot be undone.
-    #  Associated media entries may still reference this file ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
-    # @return [Ittybit::Files::FilesDeleteResponse]
+    # @return [Ittybit::ConfirmationResponse]
     # @example
     #  api = Ittybit::Client.new(
     #    base_url: "https://api.example.com",
@@ -167,17 +160,17 @@ module Ittybit
         end
         req.url "#{@request_client.get_url(request_options: request_options)}/files/#{id}"
       end
-      Ittybit::Files::FilesDeleteResponse.from_json(json_object: response.body)
+      Ittybit::ConfirmationResponse.from_json(json_object: response.body)
     end
 
-    # Updates metadata, filename, or folder properties of an existing file. Only the
-    #  specified fields will be updated.
+    # Update a file's `filename`, `folder`, `ref`, or `metadata`. Only the specified
+    #  fields will be updated.
     #
     # @param id [String]
-    # @param metadata [Hash{String => Object}] An object containing key-value pairs to set or update. Set a key to null to
-    #  remove it.
-    # @param filename [String] New filename for the file.
-    # @param folder [String] New folder path for the file.
+    # @param folder [String]
+    # @param filename [String]
+    # @param ref [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileResponse]
     # @example
@@ -188,10 +181,11 @@ module Ittybit
     #  )
     #  api.files.update(
     #    id: "id",
-    #    filename: "final_approved_video.mp4",
-    #    folder: "archive/2024"
+    #    folder: "updated/folder",
+    #    filename: "new_filename.mp4",
+    #    metadata: { "customKey2": "a different custom value" }
     #  )
-    def update(id:, metadata: nil, filename: nil, folder: nil, request_options: nil)
+    def update(id:, folder: nil, filename: nil, ref: nil, metadata: nil, request_options: nil)
       response = @request_client.conn.patch do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
@@ -206,9 +200,10 @@ module Ittybit
         end
         req.body = {
           **(request_options&.additional_body_parameters || {}),
-          metadata: metadata,
+          folder: folder,
           filename: filename,
-          folder: folder
+          ref: ref,
+          metadata: metadata
         }.compact
         req.url "#{@request_client.get_url(request_options: request_options)}/files/#{id}"
       end
@@ -227,9 +222,8 @@ module Ittybit
     end
 
     # Retrieves a paginated list of all files associated with the current project.
-    #  Files can be filtered using query parameters.
     #
-    # @param limit [Integer] Items per page
+    # @param limit [Integer]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileListResponse]
     # @example
@@ -260,16 +254,14 @@ module Ittybit
       end
     end
 
-    # Registers a file from a publicly accessible URL. The file will be ingested
-    #  asynchronously.
+    # Creates a new file from a publicly accessible or signed URL.
     #
-    # @param url [String] The publicly accessible URL of the file to ingest.
-    # @param filename [String] Optional desired filename. If not provided, it may be derived from the URL.
-    # @param folder [String] Folder path (optional)
-    # @param media_id [String] Optional existing media ID to associate the file with.
-    # @param label [String] Optional label for the file.
-    # @param metadata [Hash{String => Object}] Optional user-defined key-value metadata.
-    # @param async [Boolean] Whether to process the ingestion asynchronously.
+    # @param url [String]
+    # @param media_id [String]
+    # @param folder [String]
+    # @param filename [String]
+    # @param ref [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileResponse]
     # @example
@@ -279,13 +271,12 @@ module Ittybit
     #    token: "YOUR_AUTH_TOKEN"
     #  )
     #  api.files.create(
-    #    url: "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
-    #    filename: "bunny.mp4",
-    #    folder: "examples/cartoons",
-    #    metadata: { "credit": "gtv-videos-bucket" }
+    #    url: "https://ittyb.it/sample.mp4",
+    #    folder: "ittybit/samples",
+    #    filename: "video.mp4",
+    #    metadata: { "customKey2": "a different custom value" }
     #  )
-    def create(url:, filename: nil, folder: nil, media_id: nil, label: nil, metadata: nil, async: nil,
-               request_options: nil)
+    def create(url:, media_id: nil, folder: nil, filename: nil, ref: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -302,12 +293,11 @@ module Ittybit
           req.body = {
             **(request_options&.additional_body_parameters || {}),
             url: url,
-            filename: filename,
-            folder: folder,
             media_id: media_id,
-            label: label,
-            metadata: metadata,
-            async: async
+            folder: folder,
+            filename: filename,
+            ref: ref,
+            metadata: metadata
           }.compact
           req.url "#{@request_client.get_url(request_options: request_options)}/files"
         end
@@ -315,8 +305,7 @@ module Ittybit
       end
     end
 
-    # Retrieves detailed information about a specific file identified by its unique
-    #  ID, including its metadata, media associations, and technical properties.
+    # Retrieve the file object for a file with the given ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -352,11 +341,10 @@ module Ittybit
     end
 
     # Permanently removes a file from the system. This action cannot be undone.
-    #  Associated media entries may still reference this file ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
-    # @return [Ittybit::Files::FilesDeleteResponse]
+    # @return [Ittybit::ConfirmationResponse]
     # @example
     #  api = Ittybit::Client.new(
     #    base_url: "https://api.example.com",
@@ -383,18 +371,18 @@ module Ittybit
           end
           req.url "#{@request_client.get_url(request_options: request_options)}/files/#{id}"
         end
-        Ittybit::Files::FilesDeleteResponse.from_json(json_object: response.body)
+        Ittybit::ConfirmationResponse.from_json(json_object: response.body)
       end
     end
 
-    # Updates metadata, filename, or folder properties of an existing file. Only the
-    #  specified fields will be updated.
+    # Update a file's `filename`, `folder`, `ref`, or `metadata`. Only the specified
+    #  fields will be updated.
     #
     # @param id [String]
-    # @param metadata [Hash{String => Object}] An object containing key-value pairs to set or update. Set a key to null to
-    #  remove it.
-    # @param filename [String] New filename for the file.
-    # @param folder [String] New folder path for the file.
+    # @param folder [String]
+    # @param filename [String]
+    # @param ref [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::FileResponse]
     # @example
@@ -405,10 +393,11 @@ module Ittybit
     #  )
     #  api.files.update(
     #    id: "id",
-    #    filename: "final_approved_video.mp4",
-    #    folder: "archive/2024"
+    #    folder: "updated/folder",
+    #    filename: "new_filename.mp4",
+    #    metadata: { "customKey2": "a different custom value" }
     #  )
-    def update(id:, metadata: nil, filename: nil, folder: nil, request_options: nil)
+    def update(id:, folder: nil, filename: nil, ref: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.patch do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -424,9 +413,10 @@ module Ittybit
           end
           req.body = {
             **(request_options&.additional_body_parameters || {}),
-            metadata: metadata,
+            folder: folder,
             filename: filename,
-            folder: folder
+            ref: ref,
+            metadata: metadata
           }.compact
           req.url "#{@request_client.get_url(request_options: request_options)}/files/#{id}"
         end

data/lib/ittybit/media/client.rb

@@ -17,9 +17,9 @@ module Ittybit
       @request_client = request_client
     end
 
-    # Retrieves a list of all media for the current project
+    # Retrieves a paginated list of all media for the current project
     #
-    # @param limit [Integer] Number of media items to return per page.
+    # @param limit [Integer]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaListResponse]
     # @example
@@ -48,10 +48,11 @@ module Ittybit
       Ittybit::MediaListResponse.from_json(json_object: response.body)
     end
 
-    # Creates a new media item from a URL or as an empty placeholder
+    # Creates a new media item.
     #
-    # @param title [String] Title for the media
-    # @param metadata [Hash{String => Object}] Additional metadata for the media
+    # @param title [String]
+    # @param alt [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaResponse]
     # @example
@@ -60,8 +61,12 @@ module Ittybit
     #    environment: Ittybit::Environment::DEFAULT,
     #    token: "YOUR_AUTH_TOKEN"
     #  )
-    #  api.media.create(metadata: { "credit": "gtv-videos-bucket" })
-    def create(title: nil, metadata: nil, request_options: nil)
+    #  api.media.create(
+    #    title: "My Video Example",
+    #    alt: "An example video used to demonstrate the ittybit API",
+    #    metadata: { "customKey2": "a different custom value" }
+    #  )
+    def create(title: nil, alt: nil, metadata: nil, request_options: nil)
       response = @request_client.conn.post do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
@@ -74,13 +79,18 @@ module Ittybit
         unless request_options.nil? || request_options&.additional_query_parameters.nil?
           req.params = { **(request_options&.additional_query_parameters || {}) }.compact
         end
-        req.body = { **(request_options&.additional_body_parameters || {}), title: title, metadata: metadata }.compact
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          title: title,
+          alt: alt,
+          metadata: metadata
+        }.compact
         req.url "#{@request_client.get_url(request_options: request_options)}/media"
       end
       Ittybit::MediaResponse.from_json(json_object: response.body)
     end
 
-    # Retrieves a specific media item by its ID
+    # Retrieves the media object for a media with the given ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -113,7 +123,8 @@ module Ittybit
       Ittybit::MediaResponse.from_json(json_object: response.body)
     end
 
-    # Deletes a specific media item by its ID
+    # Permanently removes a media object from the system. This action cannot be
+    #  undone.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -146,12 +157,13 @@ module Ittybit
       Ittybit::ConfirmationResponse.from_json(json_object: response.body)
     end
 
-    # Updates specific fields of a media item by its ID. Only the fields provided in
-    #  the request body will be updated.
+    # Updates a media object's `title`, `alt`, or `metadata`. Only the specified
+    #  fields will be updated.
     #
     # @param id [String]
-    # @param title [String] New title for the media item.
-    # @param metadata [Hash{String => Object}] New metadata object for the media item. This will replace the existing metadata.
+    # @param title [String]
+    # @param alt [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaResponse]
     # @example
@@ -160,8 +172,13 @@ module Ittybit
     #    environment: Ittybit::Environment::DEFAULT,
     #    token: "YOUR_AUTH_TOKEN"
     #  )
-    #  api.media.update(id: "id")
-    def update(id:, title: nil, metadata: nil, request_options: nil)
+    #  api.media.update(
+    #    id: "id",
+    #    title: "Updated Video Example",
+    #    alt: "An updated example video used to demonstrate the ittybit API",
+    #    metadata: { "customKey2": "a different custom value" }
+    #  )
+    def update(id:, title: nil, alt: nil, metadata: nil, request_options: nil)
       response = @request_client.conn.patch do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
@@ -174,7 +191,12 @@ module Ittybit
         unless request_options.nil? || request_options&.additional_query_parameters.nil?
           req.params = { **(request_options&.additional_query_parameters || {}) }.compact
         end
-        req.body = { **(request_options&.additional_body_parameters || {}), title: title, metadata: metadata }.compact
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          title: title,
+          alt: alt,
+          metadata: metadata
+        }.compact
         req.url "#{@request_client.get_url(request_options: request_options)}/media/#{id}"
       end
       Ittybit::MediaResponse.from_json(json_object: response.body)
@@ -191,9 +213,9 @@ module Ittybit
       @request_client = request_client
     end
 
-    # Retrieves a list of all media for the current project
+    # Retrieves a paginated list of all media for the current project
     #
-    # @param limit [Integer] Number of media items to return per page.
+    # @param limit [Integer]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaListResponse]
     # @example
@@ -224,10 +246,11 @@ module Ittybit
       end
     end
 
-    # Creates a new media item from a URL or as an empty placeholder
+    # Creates a new media item.
     #
-    # @param title [String] Title for the media
-    # @param metadata [Hash{String => Object}] Additional metadata for the media
+    # @param title [String]
+    # @param alt [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaResponse]
     # @example
@@ -236,8 +259,12 @@ module Ittybit
     #    environment: Ittybit::Environment::DEFAULT,
     #    token: "YOUR_AUTH_TOKEN"
     #  )
-    #  api.media.create(metadata: { "credit": "gtv-videos-bucket" })
-    def create(title: nil, metadata: nil, request_options: nil)
+    #  api.media.create(
+    #    title: "My Video Example",
+    #    alt: "An example video used to demonstrate the ittybit API",
+    #    metadata: { "customKey2": "a different custom value" }
+    #  )
+    def create(title: nil, alt: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -251,14 +278,19 @@ module Ittybit
           unless request_options.nil? || request_options&.additional_query_parameters.nil?
             req.params = { **(request_options&.additional_query_parameters || {}) }.compact
           end
-          req.body = { **(request_options&.additional_body_parameters || {}), title: title, metadata: metadata }.compact
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            title: title,
+            alt: alt,
+            metadata: metadata
+          }.compact
           req.url "#{@request_client.get_url(request_options: request_options)}/media"
         end
         Ittybit::MediaResponse.from_json(json_object: response.body)
       end
     end
 
-    # Retrieves a specific media item by its ID
+    # Retrieves the media object for a media with the given ID.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -293,7 +325,8 @@ module Ittybit
       end
     end
 
-    # Deletes a specific media item by its ID
+    # Permanently removes a media object from the system. This action cannot be
+    #  undone.
     #
     # @param id [String]
     # @param request_options [Ittybit::RequestOptions]
@@ -328,12 +361,13 @@ module Ittybit
       end
     end
 
-    # Updates specific fields of a media item by its ID. Only the fields provided in
-    #  the request body will be updated.
+    # Updates a media object's `title`, `alt`, or `metadata`. Only the specified
+    #  fields will be updated.
     #
     # @param id [String]
-    # @param title [String] New title for the media item.
-    # @param metadata [Hash{String => Object}] New metadata object for the media item. This will replace the existing metadata.
+    # @param title [String]
+    # @param alt [String]
+    # @param metadata [Hash{String => Object}]
     # @param request_options [Ittybit::RequestOptions]
     # @return [Ittybit::MediaResponse]
     # @example
@@ -342,8 +376,13 @@ module Ittybit
     #    environment: Ittybit::Environment::DEFAULT,
     #    token: "YOUR_AUTH_TOKEN"
     #  )
-    #  api.media.update(id: "id")
-    def update(id:, title: nil, metadata: nil, request_options: nil)
+    #  api.media.update(
+    #    id: "id",
+    #    title: "Updated Video Example",
+    #    alt: "An updated example video used to demonstrate the ittybit API",
+    #    metadata: { "customKey2": "a different custom value" }
+    #  )
+    def update(id:, title: nil, alt: nil, metadata: nil, request_options: nil)
       Async do
         response = @request_client.conn.patch do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -357,7 +396,12 @@ module Ittybit
           unless request_options.nil? || request_options&.additional_query_parameters.nil?
             req.params = { **(request_options&.additional_query_parameters || {}) }.compact
           end
-          req.body = { **(request_options&.additional_body_parameters || {}), title: title, metadata: metadata }.compact
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            title: title,
+            alt: alt,
+            metadata: metadata
+          }.compact
           req.url "#{@request_client.get_url(request_options: request_options)}/media/#{id}"
         end
         Ittybit::MediaResponse.from_json(json_object: response.body)