Skip to content

feat: Updated OpenAPI spec #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
github-actions merged 1 commit into from
May 11, 2026
Merged

feat: Updated OpenAPI spec #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 0 additions & 61 deletions src/libs/RetellAI/Generated/RetellAI.IRetellAiClient.AddKnowledgeBaseSources.g.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,66 +62,5 @@ public partial interface IRetellAiClient
global::System.Collections.Generic.IList<string>? knowledgeBaseUrls = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);

/// <summary>
/// Add sources to a knowledge base
/// </summary>
/// <param name="knowledgeBaseId">
/// Example: kb_1234567890
/// </param>
/// <param name="knowledgeBaseTexts">
/// Texts to add to the knowledge base.
/// </param>
/// <param name="knowledgeBaseFiles">
/// Files to add to the knowledge base. Limit to 25 files, where each file is limited to 50MB.
/// </param>
/// <param name="knowledgeBaseFilesFileNames">
/// Optional file names to use for the multipart 'knowledge_base_files' file parts.
/// </param>
/// <param name="knowledgeBaseUrls">
/// URLs to be scraped and added to the knowledge base. Must be valid urls.<br/>
/// Example: [https://www.example.com, https://www.retellai.com]
/// </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::RetellAI.ApiException"></exception>
global::System.Threading.Tasks.Task<global::RetellAI.KnowledgeBaseResponse> AddKnowledgeBaseSourcesAsync(
string knowledgeBaseId,
global::System.Collections.Generic.IList<global::RetellAI.KnowledgeBaseAddSourcesRequestKnowledgeBaseText>? knowledgeBaseTexts = default,
global::System.Collections.Generic.IReadOnlyList<global::System.IO.Stream>? knowledgeBaseFiles = default,
global::System.Collections.Generic.IReadOnlyList<string>? knowledgeBaseFilesFileNames = default,
global::System.Collections.Generic.IList<string>? knowledgeBaseUrls = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);
/// <summary>
/// Add sources to a knowledge base
/// </summary>
/// <param name="knowledgeBaseId">
/// Example: kb_1234567890
/// </param>
/// <param name="knowledgeBaseTexts">
/// Texts to add to the knowledge base.
/// </param>
/// <param name="knowledgeBaseFiles">
/// Files to add to the knowledge base. Limit to 25 files, where each file is limited to 50MB.
/// </param>
/// <param name="knowledgeBaseFilesFileNames">
/// Optional file names to use for the multipart 'knowledge_base_files' file parts.
/// </param>
/// <param name="knowledgeBaseUrls">
/// URLs to be scraped and added to the knowledge base. Must be valid urls.<br/>
/// Example: [https://www.example.com, https://www.retellai.com]
/// </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::RetellAI.ApiException"></exception>
global::System.Threading.Tasks.Task<global::RetellAI.AutoSDKHttpResponse<global::RetellAI.KnowledgeBaseResponse>> AddKnowledgeBaseSourcesAsResponseAsync(
string knowledgeBaseId,
global::System.Collections.Generic.IList<global::RetellAI.KnowledgeBaseAddSourcesRequestKnowledgeBaseText>? knowledgeBaseTexts = default,
global::System.Collections.Generic.IReadOnlyList<global::System.IO.Stream>? knowledgeBaseFiles = default,
global::System.Collections.Generic.IReadOnlyList<string>? knowledgeBaseFilesFileNames = default,
global::System.Collections.Generic.IList<string>? knowledgeBaseUrls = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);
}
}
93 changes: 0 additions & 93 deletions src/libs/RetellAI/Generated/RetellAI.IRetellAiClient.CreateKnowledgeBase.g.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,98 +70,5 @@ public partial interface IRetellAiClient
int? minChunkSize = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);

/// <summary>
/// Create a new knowledge base
/// </summary>
/// <param name="knowledgeBaseName">
/// Name of the knowledge base. Must be less than 40 characters.<br/>
/// Example: Sample KB
/// </param>
/// <param name="knowledgeBaseTexts">
/// Texts to add to the knowledge base.
/// </param>
/// <param name="knowledgeBaseFiles">
/// Files to add to the knowledge base. Limit to 25 files, where each file is limited to 50MB.
/// </param>
/// <param name="knowledgeBaseFilesFileNames">
/// Optional file names to use for the multipart 'knowledge_base_files' file parts.
/// </param>
/// <param name="knowledgeBaseUrls">
/// URLs to be scraped and added to the knowledge base. Must be valid urls.<br/>
/// Example: [https://www.example.com, https://www.retellai.com]
/// </param>
/// <param name="enableAutoRefresh">
/// Whether to enable auto refresh for the knowledge base urls. If set to true, will retrieve the data from the specified url every 12 hours.<br/>
/// Example: true
/// </param>
/// <param name="maxChunkSize">
/// Maximum number of characters per chunk when splitting knowledge base. Default is 2000. content. Immutable after creation.<br/>
/// Example: 2000
/// </param>
/// <param name="minChunkSize">
/// Minimum number of characters per chunk. Chunks smaller than this will be merged with adjacent chunks. Must be less than max_chunk_size. Immutable after creation. Default is 400.<br/>
/// Example: 400
/// </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::RetellAI.ApiException"></exception>
global::System.Threading.Tasks.Task<global::RetellAI.KnowledgeBaseResponse> CreateKnowledgeBaseAsync(
string knowledgeBaseName,
global::System.Collections.Generic.IList<global::RetellAI.KnowledgeBaseRequestKnowledgeBaseText>? knowledgeBaseTexts = default,
global::System.Collections.Generic.IReadOnlyList<global::System.IO.Stream>? knowledgeBaseFiles = default,
global::System.Collections.Generic.IReadOnlyList<string>? knowledgeBaseFilesFileNames = default,
global::System.Collections.Generic.IList<string>? knowledgeBaseUrls = default,
bool? enableAutoRefresh = default,
int? maxChunkSize = default,
int? minChunkSize = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);
/// <summary>
/// Create a new knowledge base
/// </summary>
/// <param name="knowledgeBaseName">
/// Name of the knowledge base. Must be less than 40 characters.<br/>
/// Example: Sample KB
/// </param>
/// <param name="knowledgeBaseTexts">
/// Texts to add to the knowledge base.
/// </param>
/// <param name="knowledgeBaseFiles">
/// Files to add to the knowledge base. Limit to 25 files, where each file is limited to 50MB.
/// </param>
/// <param name="knowledgeBaseFilesFileNames">
/// Optional file names to use for the multipart 'knowledge_base_files' file parts.
/// </param>
/// <param name="knowledgeBaseUrls">
/// URLs to be scraped and added to the knowledge base. Must be valid urls.<br/>
/// Example: [https://www.example.com, https://www.retellai.com]
/// </param>
/// <param name="enableAutoRefresh">
/// Whether to enable auto refresh for the knowledge base urls. If set to true, will retrieve the data from the specified url every 12 hours.<br/>
/// Example: true
/// </param>
/// <param name="maxChunkSize">
/// Maximum number of characters per chunk when splitting knowledge base. Default is 2000. content. Immutable after creation.<br/>
/// Example: 2000
/// </param>
/// <param name="minChunkSize">
/// Minimum number of characters per chunk. Chunks smaller than this will be merged with adjacent chunks. Must be less than max_chunk_size. Immutable after creation. Default is 400.<br/>
/// Example: 400
/// </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::RetellAI.ApiException"></exception>
global::System.Threading.Tasks.Task<global::RetellAI.AutoSDKHttpResponse<global::RetellAI.KnowledgeBaseResponse>> CreateKnowledgeBaseAsResponseAsync(
string knowledgeBaseName,
global::System.Collections.Generic.IList<global::RetellAI.KnowledgeBaseRequestKnowledgeBaseText>? knowledgeBaseTexts = default,
global::System.Collections.Generic.IReadOnlyList<global::System.IO.Stream>? knowledgeBaseFiles = default,
global::System.Collections.Generic.IReadOnlyList<string>? knowledgeBaseFilesFileNames = default,
global::System.Collections.Generic.IList<string>? knowledgeBaseUrls = default,
bool? enableAutoRefresh = default,
int? maxChunkSize = default,
int? minChunkSize = default,
global::RetellAI.AutoSDKRequestOptions? requestOptions = default,
global::System.Threading.CancellationToken cancellationToken = default);
}
}
81 changes: 81 additions & 0 deletions src/libs/RetellAI/Generated/RetellAI.OptionsSupport.g.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,84 @@ public interface IAutoSDKAuthorizationProvider
global::RetellAI.AutoSDKHookContext context);
}

/// <summary>
/// Marker keys stamped onto outgoing <see cref="global::System.Net.Http.HttpRequestMessage"/>
/// instances so consumer <see cref="global::System.Net.Http.DelegatingHandler"/>s — and any
/// other transport-layer code that runs after AutoSDK's send pipeline — can observe whether
/// the resolved Authorization is call-scoped and opt out of overwriting it with a
/// rotation-aware account-level credential.
/// </summary>
public static class AutoSDKHttpRequestOptions
{
/// <summary>
/// Key under which <see cref="StampAuthorizationOverride"/> records the marker. Exposed
/// for handlers that target frameworks older than .NET 5 and need to read the value
/// through the legacy <c>HttpRequestMessage.Properties</c> bag.
/// </summary>
public const string AuthorizationOverrideKey = "AutoSDK.AuthorizationOverride";

#if NET5_0_OR_GREATER
/// <summary>
/// Strongly-typed <see cref="global::System.Net.Http.HttpRequestOptionsKey{TValue}"/> for
/// the call-scoped Authorization marker on .NET 5+ targets. Consumers should prefer this
/// over the legacy <c>HttpRequestMessage.Properties</c> bag where available.
/// </summary>
public static readonly global::System.Net.Http.HttpRequestOptionsKey<bool> AuthorizationOverride =
new global::System.Net.Http.HttpRequestOptionsKey<bool>(AuthorizationOverrideKey);
#endif

/// <summary>
/// Stamps the call-scoped Authorization marker on <paramref name="request"/>. AutoSDK's
/// built-in <see cref="AutoSDKAuthorizationProviderHook"/> calls this whenever the
/// resolved auth came from a per-request override or a client-level
/// <see cref="IAutoSDKAuthorizationProvider"/>. Hand-written SDK extensions that set a
/// non-default <c>Authorization</c> header (e.g. a session-scoped bearer returned by an
/// upstream poll) should call this too so downstream rotation handlers know to skip the
/// overwrite.
/// </summary>
/// <param name="request"></param>
public static void StampAuthorizationOverride(
global::System.Net.Http.HttpRequestMessage? request)
{
if (request is null)
{
return;
}

#if NET5_0_OR_GREATER
request.Options.Set(AuthorizationOverride, true);
#else
#pragma warning disable CS0618 // HttpRequestMessage.Properties is obsolete in NET5+, but the only option below it.
request.Properties[AuthorizationOverrideKey] = true;
#pragma warning restore CS0618
#endif
}

/// <summary>
/// Returns true when <see cref="StampAuthorizationOverride"/> previously marked the
/// request as carrying a call-scoped Authorization.
/// </summary>
/// <param name="request"></param>
public static bool HasAuthorizationOverride(
global::System.Net.Http.HttpRequestMessage? request)
{
if (request is null)
{
return false;
}

#if NET5_0_OR_GREATER
return request.Options.TryGetValue(AuthorizationOverride, out var value) && value;
#else
#pragma warning disable CS0618
return request.Properties.TryGetValue(AuthorizationOverrideKey, out var raw) &&
raw is bool flag &&
flag;
#pragma warning restore CS0618
#endif
}
}

/// <summary>
/// Built-in <see cref="IAutoSDKHook"/> that consults
/// <see cref="AutoSDKClientOptions.AuthorizationProvider"/> before every outgoing
Expand All @@ -176,6 +254,7 @@ public sealed class AutoSDKAuthorizationProviderHook : global::RetellAI.AutoSDKH
ApplyAuthorization(context.Request, perRequest[index]);
}

global::RetellAI.AutoSDKHttpRequestOptions.StampAuthorizationOverride(context.Request);
return;
}

Expand All @@ -195,6 +274,8 @@ public sealed class AutoSDKAuthorizationProviderHook : global::RetellAI.AutoSDKH
{
ApplyAuthorization(context.Request, resolved[index]);
}

global::RetellAI.AutoSDKHttpRequestOptions.StampAuthorizationOverride(context.Request);
}

private static void ApplyAuthorization(
Expand Down
Loading