feat: Updated OpenAPI spec

src/libs/Descript/Generated/Descript.ApiEndpointsClient.AgentEditJob.g.cs

@@ -618,10 +618,14 @@ partial void ProcessAgentEditJobResponseContent(
         /// Example: My New Project
         /// </param>
         /// <param name="compositionId">
-        /// Optional composition ID within the project to target. When provided,<br/>
+        /// Composition to target within the project. When provided,<br/>
         /// the agent will focus its edits on this specific composition rather<br/>
         /// than choosing one automatically. Only valid when `project_id` is also<br/>
         /// provided. Requires `project_id`.<br/>
+        /// Accepts any of the following formats:<br/>
+        /// - A full composition UUID (e.g. `39677a40-1c43-4c36-8449-46cfbc4de2b5`)<br/>
+        /// - A 5-character short ID from a Descript URL (e.g. `39677`)<br/>
+        /// - A full Descript project URL (e.g. `https://web.descript.com/{project_id}/39677`)<br/>
         /// Example: 39677a40-1c43-4c36-8449-46cfbc4de2b5
         /// </param>
         /// <param name="model">
@@ -649,7 +653,7 @@ partial void ProcessAgentEditJobResponseContent(
             string prompt,
             global::System.Guid? projectId = default,
             string? projectName = default,
-            global::System.Guid? compositionId = default,
+            string? compositionId = default,
             string? model = default,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess = default,
             string? callbackUrl = default,

src/libs/Descript/Generated/Descript.IApiEndpointsClient.AgentEditJob.g.cs

@@ -58,10 +58,14 @@ public partial interface IApiEndpointsClient
         /// Example: My New Project
         /// </param>
         /// <param name="compositionId">
-        /// Optional composition ID within the project to target. When provided,<br/>
+        /// Composition to target within the project. When provided,<br/>
         /// the agent will focus its edits on this specific composition rather<br/>
         /// than choosing one automatically. Only valid when `project_id` is also<br/>
         /// provided. Requires `project_id`.<br/>
+        /// Accepts any of the following formats:<br/>
+        /// - A full composition UUID (e.g. `39677a40-1c43-4c36-8449-46cfbc4de2b5`)<br/>
+        /// - A 5-character short ID from a Descript URL (e.g. `39677`)<br/>
+        /// - A full Descript project URL (e.g. `https://web.descript.com/{project_id}/39677`)<br/>
         /// Example: 39677a40-1c43-4c36-8449-46cfbc4de2b5
         /// </param>
         /// <param name="model">
@@ -89,7 +93,7 @@ public partial interface IApiEndpointsClient
             string prompt,
             global::System.Guid? projectId = default,
             string? projectName = default,
-            global::System.Guid? compositionId = default,
+            string? compositionId = default,
             string? model = default,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess = default,
             string? callbackUrl = default,

src/libs/Descript/Generated/Descript.Models.AgentEditJobRequest.g.cs

@@ -27,15 +27,19 @@ public sealed partial class AgentEditJobRequest
         public string? ProjectName { get; set; }
 
         /// <summary>
-        /// Optional composition ID within the project to target. When provided,<br/>
+        /// Composition to target within the project. When provided,<br/>
         /// the agent will focus its edits on this specific composition rather<br/>
         /// than choosing one automatically. Only valid when `project_id` is also<br/>
         /// provided. Requires `project_id`.<br/>
+        /// Accepts any of the following formats:<br/>
+        /// - A full composition UUID (e.g. `39677a40-1c43-4c36-8449-46cfbc4de2b5`)<br/>
+        /// - A 5-character short ID from a Descript URL (e.g. `39677`)<br/>
+        /// - A full Descript project URL (e.g. `https://web.descript.com/{project_id}/39677`)<br/>
         /// Example: 39677a40-1c43-4c36-8449-46cfbc4de2b5
         /// </summary>
         /// <example>39677a40-1c43-4c36-8449-46cfbc4de2b5</example>
         [global::System.Text.Json.Serialization.JsonPropertyName("composition_id")]
-        public global::System.Guid? CompositionId { get; set; }
+        public string? CompositionId { get; set; }
 
         /// <summary>
         /// AI model to use for editing. Defaults to the default model.
@@ -94,10 +98,14 @@ public sealed partial class AgentEditJobRequest
         /// Example: My New Project
         /// </param>
         /// <param name="compositionId">
-        /// Optional composition ID within the project to target. When provided,<br/>
+        /// Composition to target within the project. When provided,<br/>
         /// the agent will focus its edits on this specific composition rather<br/>
         /// than choosing one automatically. Only valid when `project_id` is also<br/>
         /// provided. Requires `project_id`.<br/>
+        /// Accepts any of the following formats:<br/>
+        /// - A full composition UUID (e.g. `39677a40-1c43-4c36-8449-46cfbc4de2b5`)<br/>
+        /// - A 5-character short ID from a Descript URL (e.g. `39677`)<br/>
+        /// - A full Descript project URL (e.g. `https://web.descript.com/{project_id}/39677`)<br/>
         /// Example: 39677a40-1c43-4c36-8449-46cfbc4de2b5
         /// </param>
         /// <param name="model">
@@ -120,7 +128,7 @@ public AgentEditJobRequest(
             string prompt,
             global::System.Guid? projectId,
             string? projectName,
-            global::System.Guid? compositionId,
+            string? compositionId,
             string? model,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess,
             string? callbackUrl)

src/libs/Descript/openapi.yaml

@@ -750,12 +750,16 @@ paths:
                   example: My New Project
                 composition_id:
                   type: string
-                  format: uuid
                   description: |
-                    Optional composition ID within the project to target. When provided,
+                    Composition to target within the project. When provided,
                     the agent will focus its edits on this specific composition rather
                     than choosing one automatically. Only valid when `project_id` is also
                     provided. Requires `project_id`.
+
+                    Accepts any of the following formats:
+                    - A full composition UUID (e.g. `39677a40-1c43-4c36-8449-46cfbc4de2b5`)
+                    - A 5-character short ID from a Descript URL (e.g. `39677`)
+                    - A full Descript project URL (e.g. `https://web.descript.com/{project_id}/39677`)
                   example: 39677a40-1c43-4c36-8449-46cfbc4de2b5
                 model:
                   type: string