feat: Updated OpenAPI spec

src/cli/Descript.CLI/Commands/ApiEndpointsAgentEditJobCommandApiCommand.g.cs

@@ -73,16 +73,6 @@ set of supported models and aliases.
     {
         Description = @"Optional webhook URL to call when the job completes or fails.
 Descript will POST the job status (same format as [GET /jobs/{job_id}](#operation/getJob)) to this URL.
-",
-    };
-
-    private static Option<global::System.Guid?> ConversationId { get; } = new(
-        name: @"--conversation-id")
-    {
-        Description = @"Conversation ID from a previous agent job to continue that conversation.
-Requires `project_id` (a conversation belongs to an existing project).
-When omitted, a new conversation is started. The `conversation_id` is returned
-in the job result when the job completes.
 ",
     };
       private static Option<string?> Input { get; } = new(@"--input")
@@ -154,7 +144,6 @@ public static Command Create()
                         command.Options.Add(Prompt);
                         command.Options.Add(TeamAccess);
                         command.Options.Add(CallbackUrl);
-                        command.Options.Add(ConversationId);
           command.Options.Add(Input);
           command.Options.Add(RequestJson);
           command.Options.Add(RequestFile);
@@ -187,7 +176,6 @@ await CliRuntime.RunAsync(async () =>
                         var prompt = parseResult.GetRequiredValue(Prompt);
                         var teamAccess = CliRuntime.WasSpecified(parseResult, TeamAccess) ? parseResult.GetValue(TeamAccess) : (__requestBase is { } __TeamAccessBaseValue ? __TeamAccessBaseValue.TeamAccess : default);
                         var callbackUrl = CliRuntime.WasSpecified(parseResult, CallbackUrl) ? parseResult.GetValue(CallbackUrl) : (__requestBase is { } __CallbackUrlBaseValue ? __CallbackUrlBaseValue.CallbackUrl : default);
-                        var conversationId = CliRuntime.WasSpecified(parseResult, ConversationId) ? parseResult.GetValue(ConversationId) : (__requestBase is { } __ConversationIdBaseValue ? __ConversationIdBaseValue.ConversationId : default);
                 using var client = await CliRuntime.CreateClientAsync(parseResult, cancellationToken).ConfigureAwait(false);
 
 
@@ -199,7 +187,6 @@ await CliRuntime.RunAsync(async () =>
                                     prompt: prompt,
                                     teamAccess: teamAccess,
                                     callbackUrl: callbackUrl,
-                                    conversationId: conversationId,
                                     cancellationToken: cancellationToken).ConfigureAwait(false);
 
 

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

@@ -744,13 +744,6 @@ partial void ProcessAgentEditJobResponseContent(
         /// Descript will POST the job status (same format as [GET /jobs/{job_id}](#operation/getJob)) to this URL.<br/>
         /// Example: https://example.com/webhooks/descript/job_callback
         /// </param>
-        /// <param name="conversationId">
-        /// Conversation ID from a previous agent job to continue that conversation.<br/>
-        /// Requires `project_id` (a conversation belongs to an existing project).<br/>
-        /// When omitted, a new conversation is started. The `conversation_id` is returned<br/>
-        /// in the job result when the job completes.<br/>
-        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
-        /// </param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
@@ -762,7 +755,6 @@ partial void ProcessAgentEditJobResponseContent(
             string? model = default,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess = default,
             string? callbackUrl = default,
-            global::System.Guid? conversationId = default,
             global::Descript.AutoSDKRequestOptions? requestOptions = default,
             global::System.Threading.CancellationToken cancellationToken = default)
         {
@@ -775,7 +767,6 @@ partial void ProcessAgentEditJobResponseContent(
                 Prompt = prompt,
                 TeamAccess = teamAccess,
                 CallbackUrl = callbackUrl,
-                ConversationId = conversationId,
             };
 
             return await AgentEditJobAsync(

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

@@ -119,13 +119,6 @@ public partial interface IApiEndpointsClient
         /// Descript will POST the job status (same format as [GET /jobs/{job_id}](#operation/getJob)) to this URL.<br/>
         /// Example: https://example.com/webhooks/descript/job_callback
         /// </param>
-        /// <param name="conversationId">
-        /// Conversation ID from a previous agent job to continue that conversation.<br/>
-        /// Requires `project_id` (a conversation belongs to an existing project).<br/>
-        /// When omitted, a new conversation is started. The `conversation_id` is returned<br/>
-        /// in the job result when the job completes.<br/>
-        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
-        /// </param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
@@ -137,7 +130,6 @@ public partial interface IApiEndpointsClient
             string? model = default,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess = default,
             string? callbackUrl = default,
-            global::System.Guid? conversationId = default,
             global::Descript.AutoSDKRequestOptions? requestOptions = default,
             global::System.Threading.CancellationToken cancellationToken = default);
     }

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

@@ -81,17 +81,6 @@ public sealed partial class AgentEditJobRequest
         [global::System.Text.Json.Serialization.JsonPropertyName("callback_url")]
         public string? CallbackUrl { get; set; }
 
-        /// <summary>
-        /// Conversation ID from a previous agent job to continue that conversation.<br/>
-        /// Requires `project_id` (a conversation belongs to an existing project).<br/>
-        /// When omitted, a new conversation is started. The `conversation_id` is returned<br/>
-        /// in the job result when the job completes.<br/>
-        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
-        /// </summary>
-        /// <example>a1b2c3d4-e5f6-7890-abcd-ef1234567890</example>
-        [global::System.Text.Json.Serialization.JsonPropertyName("conversation_id")]
-        public global::System.Guid? ConversationId { get; set; }
-
         /// <summary>
         /// Additional properties that are not explicitly defined in the schema
         /// </summary>
@@ -144,13 +133,6 @@ public sealed partial class AgentEditJobRequest
         /// Descript will POST the job status (same format as [GET /jobs/{job_id}](#operation/getJob)) to this URL.<br/>
         /// Example: https://example.com/webhooks/descript/job_callback
         /// </param>
-        /// <param name="conversationId">
-        /// Conversation ID from a previous agent job to continue that conversation.<br/>
-        /// Requires `project_id` (a conversation belongs to an existing project).<br/>
-        /// When omitted, a new conversation is started. The `conversation_id` is returned<br/>
-        /// in the job result when the job completes.<br/>
-        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
-        /// </param>
 #if NET7_0_OR_GREATER
         [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
 #endif
@@ -161,8 +143,7 @@ public AgentEditJobRequest(
             string? compositionId,
             string? model,
             global::Descript.AgentEditJobRequestTeamAccess? teamAccess,
-            string? callbackUrl,
-            global::System.Guid? conversationId)
+            string? callbackUrl)
         {
             this.ProjectId = projectId;
             this.ProjectName = projectName;
@@ -171,7 +152,6 @@ public AgentEditJobRequest(
             this.Prompt = prompt ?? throw new global::System.ArgumentNullException(nameof(prompt));
             this.TeamAccess = teamAccess;
             this.CallbackUrl = callbackUrl;
-            this.ConversationId = conversationId;
         }
 
         /// <summary>

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

@@ -44,6 +44,17 @@ public sealed partial class AgentEditJobResponse
         [global::System.Text.Json.Serialization.JsonRequired]
         public required string ProjectUrl { get; set; }
 
+        /// <summary>
+        /// Conversation ID for this agent run. Always returned on POST — no need<br/>
+        /// to wait for the job to complete to learn the id. Pass it back as<br/>
+        /// `conversation_id` on a subsequent call to continue this conversation.<br/>
+        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
+        /// </summary>
+        /// <example>a1b2c3d4-e5f6-7890-abcd-ef1234567890</example>
+        [global::System.Text.Json.Serialization.JsonPropertyName("conversation_id")]
+        [global::System.Text.Json.Serialization.JsonRequired]
+        public required global::System.Guid ConversationId { get; set; }
+
         /// <summary>
         /// Model reported for this request: the canonical id for an explicit<br/>
         /// model or alias (e.g. `claude-opus-4.8` for `claude-opus`), or<br/>
@@ -82,6 +93,12 @@ public sealed partial class AgentEditJobResponse
         /// URL to access the project in Descript web app<br/>
         /// Example: https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb
         /// </param>
+        /// <param name="conversationId">
+        /// Conversation ID for this agent run. Always returned on POST — no need<br/>
+        /// to wait for the job to complete to learn the id. Pass it back as<br/>
+        /// `conversation_id` on a subsequent call to continue this conversation.<br/>
+        /// Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
+        /// </param>
         /// <param name="resolvedModel">
         /// Model reported for this request: the canonical id for an explicit<br/>
         /// model or alias (e.g. `claude-opus-4.8` for `claude-opus`), or<br/>
@@ -98,12 +115,14 @@ public AgentEditJobResponse(
             global::System.Guid driveId,
             global::System.Guid projectId,
             string projectUrl,
+            global::System.Guid conversationId,
             string resolvedModel)
         {
             this.JobId = jobId;
             this.DriveId = driveId;
             this.ProjectId = projectId;
             this.ProjectUrl = projectUrl ?? throw new global::System.ArgumentNullException(nameof(projectUrl));
+            this.ConversationId = conversationId;
             this.ResolvedModel = resolvedModel ?? throw new global::System.ArgumentNullException(nameof(resolvedModel));
         }
 

src/libs/Descript/openapi.yaml

@@ -796,15 +796,6 @@ paths:
                     Optional webhook URL to call when the job completes or fails.
                     Descript will POST the job status (same format as [GET /jobs/{job_id}](#operation/getJob)) to this URL.
                   example: https://example.com/webhooks/descript/job_callback
-                conversation_id:
-                  type: string
-                  format: uuid
-                  description: |
-                    Conversation ID from a previous agent job to continue that conversation.
-                    Requires `project_id` (a conversation belongs to an existing project).
-                    When omitted, a new conversation is started. The `conversation_id` is returned
-                    in the job result when the job completes.
-                  example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
               required:
                 - prompt
               additionalProperties: false
@@ -831,12 +822,6 @@ paths:
                   project_id: 9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb
                   composition_id: 39677a40-1c43-4c36-8449-46cfbc4de2b5
                   prompt: create a 30-second highlight reel with the best moments
-              continue_conversation:
-                summary: Continue a previous conversation
-                value:
-                  project_id: 9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb
-                  prompt: now also add captions to the video
-                  conversation_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
               with_callback:
                 summary: Agent job with webhook callback
                 value:
@@ -873,6 +858,14 @@ paths:
                     format: uri
                     description: URL to access the project in Descript web app
                     example: https://web.descript.com/9f36ee32-5a2c-47e7-b1a3-94991d3e3ddb
+                  conversation_id:
+                    type: string
+                    format: uuid
+                    description: |
+                      Conversation ID for this agent run. Always returned on POST — no need
+                      to wait for the job to complete to learn the id. Pass it back as
+                      `conversation_id` on a subsequent call to continue this conversation.
+                    example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                   resolved_model:
                     type: string
                     description: |
@@ -888,6 +881,7 @@ paths:
                   - project_id
                   - project_url
                   - resolved_model
+                  - conversation_id
         '400':
           description: |
             Invalid input: