From e9a156e6b0bc61e85280dd90fee6baf0708a4755 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Thu, 10 Sep 2026 17:59:03 +0000 Subject: [PATCH] feat: Updated OpenAPI spec --- .../Speechify.AdminClient.ForceEnd.g.cs | 10 +- ...echify.DocumentsClient.CreateDocument.g.cs | 12 +- ...Speechify.DocumentsClient.PutDocument.g.cs | 12 +- .../Speechify.FilesClient.Upload.g.cs | 25 + .../Speechify.HostedApisClient.Create.g.cs | 25 +- .../Speechify.HostedApisClient.GetUsage.g.cs | 18 +- .../Speechify.HostedApisClient.Update.g.cs | 36 +- .../Speechify.IAdminClient.ForceEnd.g.cs | 10 +- ...chify.IDocumentsClient.CreateDocument.g.cs | 12 +- ...peechify.IDocumentsClient.PutDocument.g.cs | 12 +- .../Speechify.IFilesClient.Upload.g.cs | 25 + .../Speechify.IHostedApisClient.Create.g.cs | 24 +- .../Speechify.IHostedApisClient.GetUsage.g.cs | 18 +- .../Speechify.IHostedApisClient.Update.g.cs | 35 +- .../Speechify.IRoutesClient.CreateRoute.g.cs | 110 ++- .../Speechify.IRoutesClient.UpdateRoute.g.cs | 5 + .../Speechify.IStoresClient.Create.g.cs | 12 + .../Speechify.IStoresClient.List.g.cs | 16 +- ...Converters.HostedApiResolverWriteMode.g.cs | 53 ++ ...rs.HostedApiResolverWriteModeNullable.g.cs | 60 ++ .../Speechify.JsonConverters.ToolReach.g.cs | 53 ++ ...hify.JsonConverters.ToolReachNullable.g.cs | 60 ++ .../Speechify.JsonSerializerContext.g.cs | 50 +- .../Speechify.JsonSerializerContextTypes.g.cs | 860 +++++++++--------- .../Generated/Speechify.Models.AgentTool.g.cs | 21 +- .../Generated/Speechify.Models.Contact.g.cs | 18 +- .../Speechify.Models.Conversation.g.cs | 18 +- ...peechify.Models.ConversationEndReason.g.cs | 15 +- ...eechify.Models.CreateHostedAPIRequest.g.cs | 15 +- ...fy.Models.CreateHostedAPIRouteRequest.g.cs | 10 + ...Models.CreateHostedApiRequestAuthMode.g.cs | 14 +- .../Generated/Speechify.Models.ErrorCode.g.cs | 12 + .../Generated/Speechify.Models.HostedAPI.g.cs | 61 +- .../Speechify.Models.HostedAPIResolver.g.cs | 31 +- .../Speechify.Models.HostedAPIRoute.g.cs | 10 + .../Speechify.Models.HostedAPIUsage.g.cs | 22 + .../Speechify.Models.HostedApiAuthMode.g.cs | 40 +- ...peechify.Models.HostedApiResolverType.g.cs | 6 + ...ify.Models.HostedApiResolverWriteMode.g.cs | 62 ++ ...hify.Models.HostedApiUsageRoutesItems.g.cs | 12 +- .../Generated/Speechify.Models.Tool.g.cs | 31 +- .../Generated/Speechify.Models.ToolReach.g.cs | 66 ++ ...eechify.Models.UpdateHostedAPIRequest.g.cs | 9 + ...fy.Models.UpdateHostedAPIRouteRequest.g.cs | 10 + ...Models.UpdateHostedApiRequestAuthMode.g.cs | 12 + .../Speechify.RoutesClient.CreateRoute.g.cs | 110 ++- .../Speechify.RoutesClient.UpdateRoute.g.cs | 5 + .../Speechify.StoresClient.Create.g.cs | 12 + .../Speechify.StoresClient.List.g.cs | 16 +- src/libs/Speechify/openapi.yaml | 2 +- 50 files changed, 1548 insertions(+), 645 deletions(-) create mode 100644 src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteMode.g.cs create mode 100644 src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteModeNullable.g.cs create mode 100644 src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReach.g.cs create mode 100644 src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReachNullable.g.cs create mode 100644 src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverWriteMode.g.cs create mode 100644 src/libs/Speechify/Generated/Speechify.Models.ToolReach.g.cs diff --git a/src/libs/Speechify/Generated/Speechify.AdminClient.ForceEnd.g.cs b/src/libs/Speechify/Generated/Speechify.AdminClient.ForceEnd.g.cs index a6231e07..52bb1bbe 100644 --- a/src/libs/Speechify/Generated/Speechify.AdminClient.ForceEnd.g.cs +++ b/src/libs/Speechify/Generated/Speechify.AdminClient.ForceEnd.g.cs @@ -48,7 +48,10 @@ partial void ProcessForceEndResponseContent( /// Force-terminate an ongoing conversation. Idempotent: a
/// conversation that has already ended returns 204 the same as a
/// successful first-time termination. Requires an `owner` or `admin`
- /// of the workspace — the same gate as take-over. + /// of the workspace — the same gate as take-over.
+ /// The conversation records `end_reason: operator_ended`, so a
+ /// conversation closed this way can be told apart from one the agent
+ /// or the caller ended. /// /// /// @@ -75,7 +78,10 @@ partial void ProcessForceEndResponseContent( /// Force-terminate an ongoing conversation. Idempotent: a
/// conversation that has already ended returns 204 the same as a
/// successful first-time termination. Requires an `owner` or `admin`
- /// of the workspace — the same gate as take-over. + /// of the workspace — the same gate as take-over.
+ /// The conversation records `end_reason: operator_ended`, so a
+ /// conversation closed this way can be told apart from one the agent
+ /// or the caller ended. /// /// /// diff --git a/src/libs/Speechify/Generated/Speechify.DocumentsClient.CreateDocument.g.cs b/src/libs/Speechify/Generated/Speechify.DocumentsClient.CreateDocument.g.cs index 15535c95..b9b482a9 100644 --- a/src/libs/Speechify/Generated/Speechify.DocumentsClient.CreateDocument.g.cs +++ b/src/libs/Speechify/Generated/Speechify.DocumentsClient.CreateDocument.g.cs @@ -54,8 +54,8 @@ partial void ProcessCreateDocumentResponseContent( /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -96,8 +96,8 @@ partial void ProcessCreateDocumentResponseContent( /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -720,8 +720,8 @@ partial void ProcessCreateDocumentResponseContent( /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// diff --git a/src/libs/Speechify/Generated/Speechify.DocumentsClient.PutDocument.g.cs b/src/libs/Speechify/Generated/Speechify.DocumentsClient.PutDocument.g.cs index c14a1678..649765c3 100644 --- a/src/libs/Speechify/Generated/Speechify.DocumentsClient.PutDocument.g.cs +++ b/src/libs/Speechify/Generated/Speechify.DocumentsClient.PutDocument.g.cs @@ -56,8 +56,8 @@ partial void ProcessPutDocumentResponseContent( /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
@@ -104,8 +104,8 @@ partial void ProcessPutDocumentResponseContent( /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
@@ -772,8 +772,8 @@ partial void ProcessPutDocumentResponseContent( /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
diff --git a/src/libs/Speechify/Generated/Speechify.FilesClient.Upload.g.cs b/src/libs/Speechify/Generated/Speechify.FilesClient.Upload.g.cs index deeb7b13..eca352f7 100644 --- a/src/libs/Speechify/Generated/Speechify.FilesClient.Upload.g.cs +++ b/src/libs/Speechify/Generated/Speechify.FilesClient.Upload.g.cs @@ -48,6 +48,11 @@ partial void ProcessUploadResponseContent( /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -92,6 +97,11 @@ partial void ProcessUploadResponseContent( /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -817,6 +827,11 @@ request.Filename is null /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -912,6 +927,11 @@ request.Filename is null /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -1682,6 +1702,11 @@ request.Filename is null /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
diff --git a/src/libs/Speechify/Generated/Speechify.HostedApisClient.Create.g.cs b/src/libs/Speechify/Generated/Speechify.HostedApisClient.Create.g.cs index 3a797c65..3089ac4d 100644 --- a/src/libs/Speechify/Generated/Speechify.HostedApisClient.Create.g.cs +++ b/src/libs/Speechify/Generated/Speechify.HostedApisClient.Create.g.cs @@ -49,6 +49,12 @@ partial void ProcessCreateResponseContent( /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -82,6 +88,12 @@ partial void ProcessCreateResponseContent( /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -658,6 +670,12 @@ partial void ProcessCreateResponseContent( /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -670,7 +688,7 @@ partial void ProcessCreateResponseContent( /// /// /// - /// consumer_key when omitted. + /// consumer_key when omitted. `public` is refused with 403 `hosted_api_public_refused` where the workspace's policy does not allow internet-facing APIs. /// /// /// @@ -679,6 +697,9 @@ partial void ProcessCreateResponseContent( /// /// Reads the API may serve from storage per UTC day; 100000 when omitted. /// + /// + /// Documents the API's write routes may land per UTC day; 10000 when omitted. + /// /// /// /// Register the key set end-user tokens are verified against (an `https` URL on a public host). @@ -696,6 +717,7 @@ partial void ProcessCreateResponseContent( global::System.Collections.Generic.IList? corsOrigins = default, int? dailyRunCap = default, int? dailyReadCap = default, + int? dailyWriteCap = default, string? projectId = default, string? userTokenJwksUrl = default, global::Speechify.AutoSDKRequestOptions? requestOptions = default, @@ -710,6 +732,7 @@ partial void ProcessCreateResponseContent( CorsOrigins = corsOrigins, DailyRunCap = dailyRunCap, DailyReadCap = dailyReadCap, + DailyWriteCap = dailyWriteCap, ProjectId = projectId, UserTokenJwksUrl = userTokenJwksUrl, }; diff --git a/src/libs/Speechify/Generated/Speechify.HostedApisClient.GetUsage.g.cs b/src/libs/Speechify/Generated/Speechify.HostedApisClient.GetUsage.g.cs index b2f6d7a2..6faede14 100644 --- a/src/libs/Speechify/Generated/Speechify.HostedApisClient.GetUsage.g.cs +++ b/src/libs/Speechify/Generated/Speechify.HostedApisClient.GetUsage.g.cs @@ -45,10 +45,11 @@ partial void ProcessGetUsageResponseContent( /// /// Get Hosted API Usage
- /// Today's reads and runs against the API's daily caps, with each route's
- /// share of the reads. A read is a request a store, file or run_latest
- /// route answered from storage; a response served from the cache is not
- /// one. `counters_available` is false where nothing counts (no Redis), so
+ /// Today's reads, runs and writes against the API's daily caps, with each
+ /// route's share of the reads and writes. A read is a request a store,
+ /// file or run_latest route answered from storage; a response served from
+ /// the cache is not one. A write is a document a `store_write` route
+ /// landed; a replayed Idempotency-Key is not one. `counters_available` is false where nothing counts (no Redis), so
/// a zero is never mistaken for a quiet day.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// @@ -74,10 +75,11 @@ partial void ProcessGetUsageResponseContent( } /// /// Get Hosted API Usage
- /// Today's reads and runs against the API's daily caps, with each route's
- /// share of the reads. A read is a request a store, file or run_latest
- /// route answered from storage; a response served from the cache is not
- /// one. `counters_available` is false where nothing counts (no Redis), so
+ /// Today's reads, runs and writes against the API's daily caps, with each
+ /// route's share of the reads and writes. A read is a request a store,
+ /// file or run_latest route answered from storage; a response served from
+ /// the cache is not one. A write is a document a `store_write` route
+ /// landed; a replayed Idempotency-Key is not one. `counters_available` is false where nothing counts (no Redis), so
/// a zero is never mistaken for a quiet day.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// diff --git a/src/libs/Speechify/Generated/Speechify.HostedApisClient.Update.g.cs b/src/libs/Speechify/Generated/Speechify.HostedApisClient.Update.g.cs index dae4df07..29af3be7 100644 --- a/src/libs/Speechify/Generated/Speechify.HostedApisClient.Update.g.cs +++ b/src/libs/Speechify/Generated/Speechify.HostedApisClient.Update.g.cs @@ -48,10 +48,13 @@ partial void ProcessUpdateResponseContent( /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -82,10 +85,13 @@ partial void ProcessUpdateResponseContent( /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -618,10 +624,13 @@ partial void ProcessUpdateResponseContent( /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -635,6 +644,7 @@ partial void ProcessUpdateResponseContent( /// /// /// + /// /// /// Replace the registered key set; an empty string removes it, after which the signing secret verifies tokens again. /// @@ -651,6 +661,7 @@ partial void ProcessUpdateResponseContent( bool? enabled = default, int? dailyRunCap = default, int? dailyReadCap = default, + int? dailyWriteCap = default, string? userTokenJwksUrl = default, global::Speechify.AutoSDKRequestOptions? requestOptions = default, global::System.Threading.CancellationToken cancellationToken = default) @@ -664,6 +675,7 @@ partial void ProcessUpdateResponseContent( Enabled = enabled, DailyRunCap = dailyRunCap, DailyReadCap = dailyReadCap, + DailyWriteCap = dailyWriteCap, UserTokenJwksUrl = userTokenJwksUrl, }; diff --git a/src/libs/Speechify/Generated/Speechify.IAdminClient.ForceEnd.g.cs b/src/libs/Speechify/Generated/Speechify.IAdminClient.ForceEnd.g.cs index 84fd6c91..62bacb7e 100644 --- a/src/libs/Speechify/Generated/Speechify.IAdminClient.ForceEnd.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IAdminClient.ForceEnd.g.cs @@ -9,7 +9,10 @@ public partial interface IAdminClient /// Force-terminate an ongoing conversation. Idempotent: a
/// conversation that has already ended returns 204 the same as a
/// successful first-time termination. Requires an `owner` or `admin`
- /// of the workspace — the same gate as take-over. + /// of the workspace — the same gate as take-over.
+ /// The conversation records `end_reason: operator_ended`, so a
+ /// conversation closed this way can be told apart from one the agent
+ /// or the caller ended. /// /// /// @@ -26,7 +29,10 @@ public partial interface IAdminClient /// Force-terminate an ongoing conversation. Idempotent: a
/// conversation that has already ended returns 204 the same as a
/// successful first-time termination. Requires an `owner` or `admin`
- /// of the workspace — the same gate as take-over. + /// of the workspace — the same gate as take-over.
+ /// The conversation records `end_reason: operator_ended`, so a
+ /// conversation closed this way can be told apart from one the agent
+ /// or the caller ended. /// /// /// diff --git a/src/libs/Speechify/Generated/Speechify.IDocumentsClient.CreateDocument.g.cs b/src/libs/Speechify/Generated/Speechify.IDocumentsClient.CreateDocument.g.cs index 44d0cabc..d72930e8 100644 --- a/src/libs/Speechify/Generated/Speechify.IDocumentsClient.CreateDocument.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IDocumentsClient.CreateDocument.g.cs @@ -9,8 +9,8 @@ public partial interface IDocumentsClient /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -37,8 +37,8 @@ public partial interface IDocumentsClient /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -65,8 +65,8 @@ public partial interface IDocumentsClient /// Write a document, minting an id when none is given. Prefer `putDocument`
/// with a stable id you derive from the content, so a retry never
/// duplicates. Bounded by the store's document limit (409
- /// `store_document_limit_reached`). `query` and `batch` are reserved ids
- /// (400 `validation_failed`).
+ /// `store_document_limit_reached`). `query`, `batch` and `aggregate` are
+ /// reserved ids (400 `validation_failed`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// diff --git a/src/libs/Speechify/Generated/Speechify.IDocumentsClient.PutDocument.g.cs b/src/libs/Speechify/Generated/Speechify.IDocumentsClient.PutDocument.g.cs index 711c6eab..462cc8a4 100644 --- a/src/libs/Speechify/Generated/Speechify.IDocumentsClient.PutDocument.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IDocumentsClient.PutDocument.g.cs @@ -9,8 +9,8 @@ public partial interface IDocumentsClient /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
@@ -42,8 +42,8 @@ public partial interface IDocumentsClient /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
@@ -75,8 +75,8 @@ public partial interface IDocumentsClient /// Write (create or replace) a document at this id. 201 for a new
/// document, 200 for a new version of an existing one. `data` must be a
/// JSON object of at most 256 KiB; its top-level scalar fields become the
- /// queryable projection. The reserved ids `query` and `batch` are refused
- /// (400 `validation_failed`).
+ /// queryable projection. The reserved ids `query`, `batch` and
+ /// `aggregate` are refused (400 `validation_failed`).
/// Writing from a document you read? Send its `ETag` (equivalently its
/// `revision`) in `If-Match` and the write applies only if nothing has
/// changed since,
diff --git a/src/libs/Speechify/Generated/Speechify.IFilesClient.Upload.g.cs b/src/libs/Speechify/Generated/Speechify.IFilesClient.Upload.g.cs index e7b53427..ec826bca 100644 --- a/src/libs/Speechify/Generated/Speechify.IFilesClient.Upload.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IFilesClient.Upload.g.cs @@ -9,6 +9,11 @@ public partial interface IFilesClient /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -42,6 +47,11 @@ public partial interface IFilesClient /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -75,6 +85,11 @@ public partial interface IFilesClient /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -153,6 +168,11 @@ public partial interface IFilesClient /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
@@ -230,6 +250,11 @@ public partial interface IFilesClient /// Upload one file (multipart form field `file`, at most 25 MiB) so a run
/// can be handed it: pass the returned `id` in `attachments` on
/// `POST /v1/agents/{agent_id}/runs`, a team run, or a trigger's run spec.
+ /// A file uploaded with `kind: kept` and a `path` is published: a hosted
+ /// API's `file` route serves it under its own media type, and a tree of
+ /// them (`dash/index.html`, `dash/assets/main.js`) is served by one route
+ /// at `/app/*`. A path is slash-separated segments of letters, digits, or
+ /// `. _ ~ -`, no leading or trailing slash, at most 600 characters.
/// Scope it with `user_identity` to the person it belongs to, and only a
/// run acting for that person can read it; leave it empty and any run in
/// the workspace can.
diff --git a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Create.g.cs b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Create.g.cs index db3d6902..afa83240 100644 --- a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Create.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Create.g.cs @@ -8,6 +8,12 @@ public partial interface IHostedApisClient /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -29,6 +35,12 @@ public partial interface IHostedApisClient /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -50,6 +62,12 @@ public partial interface IHostedApisClient /// Create Hosted API
/// Create a hosted API. The slug is a DNS label, globally unique on the
/// shared domain (409 `hosted_api_slug_taken`) and immutable afterwards.
+ /// `auth_mode` names the audience, narrowest first: `owner`, `workspace`
+ /// (the platform's own credentials), `user_token` (a JWT your backend
+ /// signs per user), `consumer_key` (a `ck_` key you mint) or `public`
+ /// (anyone, reads only). A workspace can refuse `public` as policy (403
+ /// `hosted_api_public_refused`). Reads, runs and writes are each bounded
+ /// per UTC day (`daily_read_cap`, `daily_run_cap`, `daily_write_cap`).
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -62,7 +80,7 @@ public partial interface IHostedApisClient /// /// /// - /// consumer_key when omitted. + /// consumer_key when omitted. `public` is refused with 403 `hosted_api_public_refused` where the workspace's policy does not allow internet-facing APIs. /// /// /// @@ -71,6 +89,9 @@ public partial interface IHostedApisClient /// /// Reads the API may serve from storage per UTC day; 100000 when omitted. /// + /// + /// Documents the API's write routes may land per UTC day; 10000 when omitted. + /// /// /// /// Register the key set end-user tokens are verified against (an `https` URL on a public host). @@ -88,6 +109,7 @@ public partial interface IHostedApisClient global::System.Collections.Generic.IList? corsOrigins = default, int? dailyRunCap = default, int? dailyReadCap = default, + int? dailyWriteCap = default, string? projectId = default, string? userTokenJwksUrl = default, global::Speechify.AutoSDKRequestOptions? requestOptions = default, diff --git a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.GetUsage.g.cs b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.GetUsage.g.cs index 59004f8f..3aec1c9a 100644 --- a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.GetUsage.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.GetUsage.g.cs @@ -6,10 +6,11 @@ public partial interface IHostedApisClient { /// /// Get Hosted API Usage
- /// Today's reads and runs against the API's daily caps, with each route's
- /// share of the reads. A read is a request a store, file or run_latest
- /// route answered from storage; a response served from the cache is not
- /// one. `counters_available` is false where nothing counts (no Redis), so
+ /// Today's reads, runs and writes against the API's daily caps, with each
+ /// route's share of the reads and writes. A read is a request a store,
+ /// file or run_latest route answered from storage; a response served from
+ /// the cache is not one. A write is a document a `store_write` route
+ /// landed; a replayed Idempotency-Key is not one. `counters_available` is false where nothing counts (no Redis), so
/// a zero is never mistaken for a quiet day.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// @@ -25,10 +26,11 @@ public partial interface IHostedApisClient global::System.Threading.CancellationToken cancellationToken = default); /// /// Get Hosted API Usage
- /// Today's reads and runs against the API's daily caps, with each route's
- /// share of the reads. A read is a request a store, file or run_latest
- /// route answered from storage; a response served from the cache is not
- /// one. `counters_available` is false where nothing counts (no Redis), so
+ /// Today's reads, runs and writes against the API's daily caps, with each
+ /// route's share of the reads and writes. A read is a request a store,
+ /// file or run_latest route answered from storage; a response served from
+ /// the cache is not one. A write is a document a `store_write` route
+ /// landed; a replayed Idempotency-Key is not one. `counters_available` is false where nothing counts (no Redis), so
/// a zero is never mistaken for a quiet day.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// diff --git a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Update.g.cs b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Update.g.cs index e7e5699e..23296758 100644 --- a/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Update.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IHostedApisClient.Update.g.cs @@ -7,10 +7,13 @@ public partial interface IHostedApisClient /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -29,10 +32,13 @@ public partial interface IHostedApisClient /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -51,10 +57,13 @@ public partial interface IHostedApisClient /// /// Update Hosted API
/// Update a hosted API (merge-patch). Switching to `public` is refused
- /// while a `run` route exists: an anonymous caller must not start runs
- /// that spend the workspace's budget. Switching away from `user_token`
- /// is refused while a route binds `{{user.*}}`: nothing else supplies
- /// a user.
+ /// while a `run` or `store_write` route exists: an anonymous caller must
+ /// not start runs that spend the workspace's budget or write to a store,
+ /// and it is refused outright where the workspace's policy does not allow
+ /// internet-facing APIs (403 `hosted_api_public_refused`). Switching to a
+ /// mode that names no caller (`consumer_key`, `public`) is refused while
+ /// a route binds `{{user.*}}`: only `user_token`, `workspace` and `owner`
+ /// supply a person.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -68,6 +77,7 @@ public partial interface IHostedApisClient /// /// /// + /// /// /// Replace the registered key set; an empty string removes it, after which the signing secret verifies tokens again. /// @@ -84,6 +94,7 @@ public partial interface IHostedApisClient bool? enabled = default, int? dailyRunCap = default, int? dailyReadCap = default, + int? dailyWriteCap = default, string? userTokenJwksUrl = default, global::Speechify.AutoSDKRequestOptions? requestOptions = default, global::System.Threading.CancellationToken cancellationToken = default); diff --git a/src/libs/Speechify/Generated/Speechify.IRoutesClient.CreateRoute.g.cs b/src/libs/Speechify/Generated/Speechify.IRoutesClient.CreateRoute.g.cs index 07b56ebc..32a8b8be 100644 --- a/src/libs/Speechify/Generated/Speechify.IRoutesClient.CreateRoute.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IRoutesClient.CreateRoute.g.cs @@ -6,21 +6,26 @@ public partial interface IRoutesClient { /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -42,21 +47,26 @@ public partial interface IRoutesClient global::System.Threading.CancellationToken cancellationToken = default); /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -78,21 +88,26 @@ public partial interface IRoutesClient global::System.Threading.CancellationToken cancellationToken = default); /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -113,6 +128,11 @@ public partial interface IRoutesClient /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.IRoutesClient.UpdateRoute.g.cs b/src/libs/Speechify/Generated/Speechify.IRoutesClient.UpdateRoute.g.cs index 87ecd2f5..c3274fb6 100644 --- a/src/libs/Speechify/Generated/Speechify.IRoutesClient.UpdateRoute.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IRoutesClient.UpdateRoute.g.cs @@ -63,6 +63,11 @@ public partial interface IRoutesClient /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.IStoresClient.Create.g.cs b/src/libs/Speechify/Generated/Speechify.IStoresClient.Create.g.cs index 6c4586ef..2b7e0c50 100644 --- a/src/libs/Speechify/Generated/Speechify.IStoresClient.Create.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IStoresClient.Create.g.cs @@ -8,6 +8,10 @@ public partial interface IStoresClient /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -29,6 +33,10 @@ public partial interface IStoresClient /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -50,6 +58,10 @@ public partial interface IStoresClient /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// diff --git a/src/libs/Speechify/Generated/Speechify.IStoresClient.List.g.cs b/src/libs/Speechify/Generated/Speechify.IStoresClient.List.g.cs index 2b4a2712..a5076543 100644 --- a/src/libs/Speechify/Generated/Speechify.IStoresClient.List.g.cs +++ b/src/libs/Speechify/Generated/Speechify.IStoresClient.List.g.cs @@ -7,8 +7,12 @@ public partial interface IStoresClient /// /// List Stores
/// List the stores in the caller's workspace, most recently updated
- /// first. A store is the durable collection of JSON documents a durable
- /// run writes to (through its store tools) and a hosted-API route serves.
+ /// first. A store is a workspace-owned database of JSON documents in
+ /// named collections, Firestore-shaped: filter on top-level scalar
+ /// fields, order on one, page with a cursor, and aggregate in one
+ /// request; no joins, nested-field filters, full-text search or SQL, on
+ /// purpose. A durable run writes it through its store tools, a hosted-API
+ /// route serves it, and your own backend reads and writes it here.
/// Uploaded bytes are not stores: a file is its own resource at
/// `/v1/files`.
/// Cursor-paginated; walk pages while `has_more` is true.
@@ -33,8 +37,12 @@ public partial interface IStoresClient /// /// List Stores
/// List the stores in the caller's workspace, most recently updated
- /// first. A store is the durable collection of JSON documents a durable
- /// run writes to (through its store tools) and a hosted-API route serves.
+ /// first. A store is a workspace-owned database of JSON documents in
+ /// named collections, Firestore-shaped: filter on top-level scalar
+ /// fields, order on one, page with a cursor, and aggregate in one
+ /// request; no joins, nested-field filters, full-text search or SQL, on
+ /// purpose. A durable run writes it through its store tools, a hosted-API
+ /// route serves it, and your own backend reads and writes it here.
/// Uploaded bytes are not stores: a file is its own resource at
/// `/v1/files`.
/// Cursor-paginated; walk pages while `has_more` is true.
diff --git a/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteMode.g.cs b/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteMode.g.cs new file mode 100644 index 00000000..6713434e --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteMode.g.cs @@ -0,0 +1,53 @@ +#nullable enable + +namespace Speechify.JsonConverters +{ + /// + public sealed class HostedApiResolverWriteModeJsonConverter : global::System.Text.Json.Serialization.JsonConverter + { + /// + public override global::Speechify.HostedApiResolverWriteMode Read( + ref global::System.Text.Json.Utf8JsonReader reader, + global::System.Type typeToConvert, + global::System.Text.Json.JsonSerializerOptions options) + { + switch (reader.TokenType) + { + case global::System.Text.Json.JsonTokenType.String: + { + var stringValue = reader.GetString(); + if (stringValue != null) + { + return global::Speechify.HostedApiResolverWriteModeExtensions.ToEnum(stringValue) ?? default; + } + + break; + } + case global::System.Text.Json.JsonTokenType.Number: + { + var numValue = reader.GetInt32(); + return (global::Speechify.HostedApiResolverWriteMode)numValue; + } + case global::System.Text.Json.JsonTokenType.Null: + { + return default(global::Speechify.HostedApiResolverWriteMode); + } + default: + throw new global::System.ArgumentOutOfRangeException(nameof(reader)); + } + + return default; + } + + /// + public override void Write( + global::System.Text.Json.Utf8JsonWriter writer, + global::Speechify.HostedApiResolverWriteMode value, + global::System.Text.Json.JsonSerializerOptions options) + { + writer = writer ?? throw new global::System.ArgumentNullException(nameof(writer)); + + writer.WriteStringValue(global::Speechify.HostedApiResolverWriteModeExtensions.ToValueString(value)); + } + } +} diff --git a/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteModeNullable.g.cs b/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteModeNullable.g.cs new file mode 100644 index 00000000..4015d663 --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.JsonConverters.HostedApiResolverWriteModeNullable.g.cs @@ -0,0 +1,60 @@ +#nullable enable + +namespace Speechify.JsonConverters +{ + /// + public sealed class HostedApiResolverWriteModeNullableJsonConverter : global::System.Text.Json.Serialization.JsonConverter + { + /// + public override global::Speechify.HostedApiResolverWriteMode? Read( + ref global::System.Text.Json.Utf8JsonReader reader, + global::System.Type typeToConvert, + global::System.Text.Json.JsonSerializerOptions options) + { + switch (reader.TokenType) + { + case global::System.Text.Json.JsonTokenType.String: + { + var stringValue = reader.GetString(); + if (stringValue != null) + { + return global::Speechify.HostedApiResolverWriteModeExtensions.ToEnum(stringValue); + } + + break; + } + case global::System.Text.Json.JsonTokenType.Number: + { + var numValue = reader.GetInt32(); + return (global::Speechify.HostedApiResolverWriteMode)numValue; + } + case global::System.Text.Json.JsonTokenType.Null: + { + return default(global::Speechify.HostedApiResolverWriteMode?); + } + default: + throw new global::System.ArgumentOutOfRangeException(nameof(reader)); + } + + return default; + } + + /// + public override void Write( + global::System.Text.Json.Utf8JsonWriter writer, + global::Speechify.HostedApiResolverWriteMode? value, + global::System.Text.Json.JsonSerializerOptions options) + { + writer = writer ?? throw new global::System.ArgumentNullException(nameof(writer)); + + if (value == null) + { + writer.WriteNullValue(); + } + else + { + writer.WriteStringValue(global::Speechify.HostedApiResolverWriteModeExtensions.ToValueString(value.Value)); + } + } + } +} diff --git a/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReach.g.cs b/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReach.g.cs new file mode 100644 index 00000000..51907ae3 --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReach.g.cs @@ -0,0 +1,53 @@ +#nullable enable + +namespace Speechify.JsonConverters +{ + /// + public sealed class ToolReachJsonConverter : global::System.Text.Json.Serialization.JsonConverter + { + /// + public override global::Speechify.ToolReach Read( + ref global::System.Text.Json.Utf8JsonReader reader, + global::System.Type typeToConvert, + global::System.Text.Json.JsonSerializerOptions options) + { + switch (reader.TokenType) + { + case global::System.Text.Json.JsonTokenType.String: + { + var stringValue = reader.GetString(); + if (stringValue != null) + { + return global::Speechify.ToolReachExtensions.ToEnum(stringValue) ?? default; + } + + break; + } + case global::System.Text.Json.JsonTokenType.Number: + { + var numValue = reader.GetInt32(); + return (global::Speechify.ToolReach)numValue; + } + case global::System.Text.Json.JsonTokenType.Null: + { + return default(global::Speechify.ToolReach); + } + default: + throw new global::System.ArgumentOutOfRangeException(nameof(reader)); + } + + return default; + } + + /// + public override void Write( + global::System.Text.Json.Utf8JsonWriter writer, + global::Speechify.ToolReach value, + global::System.Text.Json.JsonSerializerOptions options) + { + writer = writer ?? throw new global::System.ArgumentNullException(nameof(writer)); + + writer.WriteStringValue(global::Speechify.ToolReachExtensions.ToValueString(value)); + } + } +} diff --git a/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReachNullable.g.cs b/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReachNullable.g.cs new file mode 100644 index 00000000..6734764f --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.JsonConverters.ToolReachNullable.g.cs @@ -0,0 +1,60 @@ +#nullable enable + +namespace Speechify.JsonConverters +{ + /// + public sealed class ToolReachNullableJsonConverter : global::System.Text.Json.Serialization.JsonConverter + { + /// + public override global::Speechify.ToolReach? Read( + ref global::System.Text.Json.Utf8JsonReader reader, + global::System.Type typeToConvert, + global::System.Text.Json.JsonSerializerOptions options) + { + switch (reader.TokenType) + { + case global::System.Text.Json.JsonTokenType.String: + { + var stringValue = reader.GetString(); + if (stringValue != null) + { + return global::Speechify.ToolReachExtensions.ToEnum(stringValue); + } + + break; + } + case global::System.Text.Json.JsonTokenType.Number: + { + var numValue = reader.GetInt32(); + return (global::Speechify.ToolReach)numValue; + } + case global::System.Text.Json.JsonTokenType.Null: + { + return default(global::Speechify.ToolReach?); + } + default: + throw new global::System.ArgumentOutOfRangeException(nameof(reader)); + } + + return default; + } + + /// + public override void Write( + global::System.Text.Json.Utf8JsonWriter writer, + global::Speechify.ToolReach? value, + global::System.Text.Json.JsonSerializerOptions options) + { + writer = writer ?? throw new global::System.ArgumentNullException(nameof(writer)); + + if (value == null) + { + writer.WriteNullValue(); + } + else + { + writer.WriteStringValue(global::Speechify.ToolReachExtensions.ToValueString(value.Value)); + } + } + } +} diff --git a/src/libs/Speechify/Generated/Speechify.JsonSerializerContext.g.cs b/src/libs/Speechify/Generated/Speechify.JsonSerializerContext.g.cs index 5c759dc7..7a9b79ba 100644 --- a/src/libs/Speechify/Generated/Speechify.JsonSerializerContext.g.cs +++ b/src/libs/Speechify/Generated/Speechify.JsonSerializerContext.g.cs @@ -388,7 +388,9 @@ namespace Speechify [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.Dictionary))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.AgentToolConfig), TypeInfoPropertyName = "AgentToolConfig2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolApprovalClass), TypeInfoPropertyName = "ToolApprovalClass2")] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolReach), TypeInfoPropertyName = "ToolReach2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.AgentTool))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ListAgentToolsResponse))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.CreateAgentToolRequestConfig), TypeInfoPropertyName = "CreateAgentToolRequestConfig2")] @@ -512,8 +514,6 @@ namespace Speechify [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.PhoneNumberReputation))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.PhoneNumber))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ListPhoneNumbersResponse))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] internal sealed partial class SourceGenerationContextChunk0 : global::System.Text.Json.Serialization.JsonSerializerContext { } @@ -526,6 +526,8 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex Converters = new global::System.Type[] { })] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ListPhoneNumbersResponse))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.TwilioImportSpec))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.TelnyxImportSpec))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ImportPhoneNumberRequest))] @@ -669,6 +671,7 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiRouteMethod), TypeInfoPropertyName = "HostedApiRouteMethod2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverType), TypeInfoPropertyName = "HostedApiResolverType2")] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverWriteMode), TypeInfoPropertyName = "HostedApiResolverWriteMode2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverWhereItemsOp), TypeInfoPropertyName = "HostedApiResolverWhereItemsOp2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverWhereItems))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverOrderByDirection), TypeInfoPropertyName = "HostedApiResolverOrderByDirection2")] @@ -855,6 +858,7 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolActionClass?), TypeInfoPropertyName = "NullableToolActionClass2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.AgentToolConfig?), TypeInfoPropertyName = "NullableAgentToolConfig2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolApprovalClass?), TypeInfoPropertyName = "NullableToolApprovalClass2")] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolReach?), TypeInfoPropertyName = "NullableToolReach2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.CreateAgentToolRequestConfig?), TypeInfoPropertyName = "NullableCreateAgentToolRequestConfig2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.ToolNameHolderKind?), TypeInfoPropertyName = "NullableToolNameHolderKind2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.UpdateAgentToolRequestConfig?), TypeInfoPropertyName = "NullableUpdateAgentToolRequestConfig2")] @@ -907,6 +911,7 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.UpdateHostedApiRequestAuthMode?), TypeInfoPropertyName = "NullableUpdateHostedApiRequestAuthMode2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiRouteMethod?), TypeInfoPropertyName = "NullableHostedApiRouteMethod2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverType?), TypeInfoPropertyName = "NullableHostedApiResolverType2")] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverWriteMode?), TypeInfoPropertyName = "NullableHostedApiResolverWriteMode2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverWhereItemsOp?), TypeInfoPropertyName = "NullableHostedApiResolverWhereItemsOp2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.HostedApiResolverOrderByDirection?), TypeInfoPropertyName = "NullableHostedApiResolverOrderByDirection2")] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Speechify.CreateHostedApiRouteRequestMethod?), TypeInfoPropertyName = "NullableCreateHostedApiRouteRequestMethod2")] @@ -985,6 +990,7 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] @@ -1020,12 +1026,6 @@ internal sealed partial class SourceGenerationContextChunk0 : global::System.Tex [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] - [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] internal sealed partial class SourceGenerationContextChunk1 : global::System.Text.Json.Serialization.JsonSerializerContext { } @@ -1038,6 +1038,12 @@ internal sealed partial class SourceGenerationContextChunk1 : global::System.Tex Converters = new global::System.Type[] { })] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] + [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] [global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.List))] @@ -1476,6 +1482,10 @@ public override bool CanConvert(global::System.Type typeToConvert) || typeToConvert == typeof(global::Speechify.ToolApprovalClass?) + || typeToConvert == typeof(global::Speechify.ToolReach) + + || typeToConvert == typeof(global::Speechify.ToolReach?) + || typeToConvert == typeof(global::Speechify.ToolNameHolderKind) || typeToConvert == typeof(global::Speechify.ToolNameHolderKind?) @@ -1652,6 +1662,10 @@ public override bool CanConvert(global::System.Type typeToConvert) || typeToConvert == typeof(global::Speechify.HostedApiResolverType?) + || typeToConvert == typeof(global::Speechify.HostedApiResolverWriteMode) + + || typeToConvert == typeof(global::Speechify.HostedApiResolverWriteMode?) + || typeToConvert == typeof(global::Speechify.HostedApiResolverWhereItemsOp) || typeToConvert == typeof(global::Speechify.HostedApiResolverWhereItemsOp?) @@ -2583,6 +2597,16 @@ public override bool CanConvert(global::System.Type typeToConvert) return new global::Speechify.JsonConverters.ToolApprovalClassNullableJsonConverter(); } + if (typeToConvert == typeof(global::Speechify.ToolReach)) + { + return new global::Speechify.JsonConverters.ToolReachJsonConverter(); + } + + if (typeToConvert == typeof(global::Speechify.ToolReach?)) + { + return new global::Speechify.JsonConverters.ToolReachNullableJsonConverter(); + } + if (typeToConvert == typeof(global::Speechify.ToolNameHolderKind)) { return new global::Speechify.JsonConverters.ToolNameHolderKindJsonConverter(); @@ -3023,6 +3047,16 @@ public override bool CanConvert(global::System.Type typeToConvert) return new global::Speechify.JsonConverters.HostedApiResolverTypeNullableJsonConverter(); } + if (typeToConvert == typeof(global::Speechify.HostedApiResolverWriteMode)) + { + return new global::Speechify.JsonConverters.HostedApiResolverWriteModeJsonConverter(); + } + + if (typeToConvert == typeof(global::Speechify.HostedApiResolverWriteMode?)) + { + return new global::Speechify.JsonConverters.HostedApiResolverWriteModeNullableJsonConverter(); + } + if (typeToConvert == typeof(global::Speechify.HostedApiResolverWhereItemsOp)) { return new global::Speechify.JsonConverters.HostedApiResolverWhereItemsOpJsonConverter(); diff --git a/src/libs/Speechify/Generated/Speechify.JsonSerializerContextTypes.g.cs b/src/libs/Speechify/Generated/Speechify.JsonSerializerContextTypes.g.cs index 381cc9e6..8692b61a 100644 --- a/src/libs/Speechify/Generated/Speechify.JsonSerializerContextTypes.g.cs +++ b/src/libs/Speechify/Generated/Speechify.JsonSerializerContextTypes.g.cs @@ -1517,1439 +1517,1451 @@ public sealed partial class JsonSerializerContextTypes /// /// /// - public global::Speechify.AgentTool? Type371 { get; set; } + public global::Speechify.ToolReach? Type371 { get; set; } /// /// /// - public global::Speechify.ListAgentToolsResponse? Type372 { get; set; } + public global::Speechify.AgentTool? Type372 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type373 { get; set; } + public global::System.Collections.Generic.IList? Type373 { get; set; } /// /// /// - public global::Speechify.CreateAgentToolRequestConfig? Type374 { get; set; } + public global::Speechify.ListAgentToolsResponse? Type374 { get; set; } /// /// /// - public global::Speechify.CreateAgentToolRequest? Type375 { get; set; } + public global::System.Collections.Generic.IList? Type375 { get; set; } /// /// /// - public global::Speechify.ToolNameHolderKind? Type376 { get; set; } + public global::Speechify.CreateAgentToolRequestConfig? Type376 { get; set; } /// /// /// - public global::Speechify.ToolNameHolder? Type377 { get; set; } + public global::Speechify.CreateAgentToolRequest? Type377 { get; set; } /// /// /// - public global::Speechify.ToolNameTakenErrorDetailDetails? Type378 { get; set; } + public global::Speechify.ToolNameHolderKind? Type378 { get; set; } /// /// /// - public global::Speechify.ToolNameTakenErrorDetail? Type379 { get; set; } + public global::Speechify.ToolNameHolder? Type379 { get; set; } /// /// /// - public global::Speechify.ToolNameTakenError? Type380 { get; set; } + public global::Speechify.ToolNameTakenErrorDetailDetails? Type380 { get; set; } /// /// /// - public global::Speechify.UpdateAgentToolRequestConfig? Type381 { get; set; } + public global::Speechify.ToolNameTakenErrorDetail? Type381 { get; set; } /// /// /// - public global::Speechify.UpdateAgentToolRequest? Type382 { get; set; } + public global::Speechify.ToolNameTakenError? Type382 { get; set; } /// /// /// - public global::Speechify.ToolConfig? Type383 { get; set; } + public global::Speechify.UpdateAgentToolRequestConfig? Type383 { get; set; } /// /// /// - public global::Speechify.Tool? Type384 { get; set; } + public global::Speechify.UpdateAgentToolRequest? Type384 { get; set; } /// /// /// - public global::Speechify.ListToolsResponse? Type385 { get; set; } + public global::Speechify.ToolConfig? Type385 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type386 { get; set; } + public global::Speechify.Tool? Type386 { get; set; } /// /// /// - public global::Speechify.CreateToolRequestConfig? Type387 { get; set; } + public global::Speechify.ListToolsResponse? Type387 { get; set; } /// /// /// - public global::Speechify.CreateToolRequest? Type388 { get; set; } + public global::System.Collections.Generic.IList? Type388 { get; set; } /// /// /// - public global::Speechify.UpdateToolRequestConfig? Type389 { get; set; } + public global::Speechify.CreateToolRequestConfig? Type389 { get; set; } /// /// /// - public global::Speechify.UpdateToolRequest? Type390 { get; set; } + public global::Speechify.CreateToolRequest? Type390 { get; set; } /// /// /// - public global::Speechify.ToolAttachedAgent? Type391 { get; set; } + public global::Speechify.UpdateToolRequestConfig? Type391 { get; set; } /// /// /// - public global::Speechify.ListToolAttachedAgentsResponse? Type392 { get; set; } + public global::Speechify.UpdateToolRequest? Type392 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type393 { get; set; } + public global::Speechify.ToolAttachedAgent? Type393 { get; set; } /// /// /// - public global::Speechify.TestMCPConnectionRequest? Type394 { get; set; } + public global::Speechify.ListToolAttachedAgentsResponse? Type394 { get; set; } /// /// /// - public global::Speechify.MCPProbeTool? Type395 { get; set; } + public global::System.Collections.Generic.IList? Type395 { get; set; } /// /// /// - public global::Speechify.McpProbeErrorDetailsStage? Type396 { get; set; } + public global::Speechify.TestMCPConnectionRequest? Type396 { get; set; } /// /// /// - public global::Speechify.MCPProbeErrorDetails? Type397 { get; set; } + public global::Speechify.MCPProbeTool? Type397 { get; set; } /// /// /// - public global::Speechify.MCPProbeResult? Type398 { get; set; } + public global::Speechify.McpProbeErrorDetailsStage? Type398 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type399 { get; set; } + public global::Speechify.MCPProbeErrorDetails? Type399 { get; set; } /// /// /// - public global::Speechify.TestWebhookConnectionRequest? Type400 { get; set; } + public global::Speechify.MCPProbeResult? Type400 { get; set; } /// /// /// - public global::Speechify.WebhookProbeResult? Type401 { get; set; } + public global::System.Collections.Generic.IList? Type401 { get; set; } /// /// /// - public global::Speechify.SystemBuiltinInfoExecution? Type402 { get; set; } + public global::Speechify.TestWebhookConnectionRequest? Type402 { get; set; } /// /// /// - public global::Speechify.SystemBuiltinInfo? Type403 { get; set; } + public global::Speechify.WebhookProbeResult? Type403 { get; set; } /// /// /// - public global::Speechify.ListSystemBuiltinsResponse? Type404 { get; set; } + public global::Speechify.SystemBuiltinInfoExecution? Type404 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type405 { get; set; } + public global::Speechify.SystemBuiltinInfo? Type405 { get; set; } /// /// /// - public global::Speechify.TestType? Type406 { get; set; } + public global::Speechify.ListSystemBuiltinsResponse? Type406 { get; set; } /// /// /// - public global::Speechify.SimulationMessageRole? Type407 { get; set; } + public global::System.Collections.Generic.IList? Type407 { get; set; } /// /// /// - public global::Speechify.SimulationMessage? Type408 { get; set; } + public global::Speechify.TestType? Type408 { get; set; } /// /// /// - public global::Speechify.ReplyConfig? Type409 { get; set; } + public global::Speechify.SimulationMessageRole? Type409 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type410 { get; set; } + public global::Speechify.SimulationMessage? Type410 { get; set; } /// /// /// - public global::Speechify.ParameterCheckMode? Type411 { get; set; } + public global::Speechify.ReplyConfig? Type411 { get; set; } /// /// /// - public global::Speechify.ParameterCheck? Type412 { get; set; } + public global::System.Collections.Generic.IList? Type412 { get; set; } /// /// /// - public global::Speechify.ToolCallConfig? Type413 { get; set; } + public global::Speechify.ParameterCheckMode? Type413 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type414 { get; set; } + public global::Speechify.ParameterCheck? Type414 { get; set; } /// /// /// - public global::Speechify.DataAssertionMode? Type415 { get; set; } + public global::Speechify.ToolCallConfig? Type415 { get; set; } /// /// /// - public global::Speechify.DataAssertion? Type416 { get; set; } + public global::System.Collections.Generic.IList? Type416 { get; set; } /// /// /// - public global::Speechify.SimulationConfig? Type417 { get; set; } + public global::Speechify.DataAssertionMode? Type417 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type418 { get; set; } + public global::Speechify.DataAssertion? Type418 { get; set; } /// /// /// - public global::Speechify.CreateAgentTestRequestConfig? Type419 { get; set; } + public global::Speechify.SimulationConfig? Type419 { get; set; } /// /// /// - public global::Speechify.MockingStrategy? Type420 { get; set; } + public global::System.Collections.Generic.IList? Type420 { get; set; } /// /// /// - public global::Speechify.ToolMock? Type421 { get; set; } + public global::Speechify.CreateAgentTestRequestConfig? Type421 { get; set; } /// /// /// - public global::Speechify.NoMatchBehavior? Type422 { get; set; } + public global::Speechify.MockingStrategy? Type422 { get; set; } /// /// /// - public global::Speechify.ToolMockConfig? Type423 { get; set; } + public global::Speechify.ToolMock? Type423 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type424 { get; set; } + public global::Speechify.NoMatchBehavior? Type424 { get; set; } /// /// /// - public global::Speechify.CreateAgentTestRequest? Type425 { get; set; } + public global::Speechify.ToolMockConfig? Type425 { get; set; } /// /// /// - public global::Speechify.AgentTestConfig? Type426 { get; set; } + public global::System.Collections.Generic.IList? Type426 { get; set; } /// /// /// - public global::Speechify.AgentTest? Type427 { get; set; } + public global::Speechify.CreateAgentTestRequest? Type427 { get; set; } /// /// /// - public global::Speechify.TestVerdict? Type428 { get; set; } + public global::Speechify.AgentTestConfig? Type428 { get; set; } /// /// /// - public global::Speechify.ReplyResult? Type429 { get; set; } + public global::Speechify.AgentTest? Type429 { get; set; } /// /// /// - public global::Speechify.ParameterCheckResult? Type430 { get; set; } + public global::Speechify.TestVerdict? Type430 { get; set; } /// /// /// - public global::Speechify.ToolCallResult? Type431 { get; set; } + public global::Speechify.ReplyResult? Type431 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type432 { get; set; } + public global::Speechify.ParameterCheckResult? Type432 { get; set; } /// /// /// - public global::Speechify.SimulationToolCall? Type433 { get; set; } + public global::Speechify.ToolCallResult? Type433 { get; set; } /// /// /// - public global::Speechify.SimulationResultSentiment? Type434 { get; set; } + public global::System.Collections.Generic.IList? Type434 { get; set; } /// /// /// - public global::Speechify.SimulationCriterionResultStatus? Type435 { get; set; } + public global::Speechify.SimulationToolCall? Type435 { get; set; } /// /// /// - public global::Speechify.SimulationCriterionResult? Type436 { get; set; } + public global::Speechify.SimulationResultSentiment? Type436 { get; set; } /// /// /// - public global::Speechify.DataAssertionResultMode? Type437 { get; set; } + public global::Speechify.SimulationCriterionResultStatus? Type437 { get; set; } /// /// /// - public global::Speechify.DataAssertionResult? Type438 { get; set; } + public global::Speechify.SimulationCriterionResult? Type438 { get; set; } /// /// /// - public global::Speechify.SimulationResult? Type439 { get; set; } + public global::Speechify.DataAssertionResultMode? Type439 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type440 { get; set; } + public global::Speechify.DataAssertionResult? Type440 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type441 { get; set; } + public global::Speechify.SimulationResult? Type441 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type442 { get; set; } + public global::System.Collections.Generic.IList? Type442 { get; set; } /// /// /// - public global::Speechify.TestRunResult? Type443 { get; set; } + public global::System.Collections.Generic.IList? Type443 { get; set; } /// /// /// - public global::Speechify.AgentTestRun? Type444 { get; set; } + public global::System.Collections.Generic.IList? Type444 { get; set; } /// /// /// - public global::Speechify.AgentTestWithLastRun? Type445 { get; set; } + public global::Speechify.TestRunResult? Type445 { get; set; } /// /// /// - public global::Speechify.ListTestsResponse? Type446 { get; set; } + public global::Speechify.AgentTestRun? Type446 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type447 { get; set; } + public global::Speechify.AgentTestWithLastRun? Type447 { get; set; } /// /// /// - public global::Speechify.UpdateAgentTestRequestConfig? Type448 { get; set; } + public global::Speechify.ListTestsResponse? Type448 { get; set; } /// /// /// - public global::Speechify.UpdateAgentTestRequest? Type449 { get; set; } + public global::System.Collections.Generic.IList? Type449 { get; set; } /// /// /// - public global::Speechify.AgentTestFolder? Type450 { get; set; } + public global::Speechify.UpdateAgentTestRequestConfig? Type450 { get; set; } /// /// /// - public global::Speechify.ListAgentTestFoldersResponse? Type451 { get; set; } + public global::Speechify.UpdateAgentTestRequest? Type451 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type452 { get; set; } + public global::Speechify.AgentTestFolder? Type452 { get; set; } /// /// /// - public global::Speechify.CreateAgentTestFolderRequest? Type453 { get; set; } + public global::Speechify.ListAgentTestFoldersResponse? Type453 { get; set; } /// /// /// - public global::Speechify.UpdateAgentTestFolderRequest? Type454 { get; set; } + public global::System.Collections.Generic.IList? Type454 { get; set; } /// /// /// - public global::Speechify.ListAgentTestRunsResponse? Type455 { get; set; } + public global::Speechify.CreateAgentTestFolderRequest? Type455 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type456 { get; set; } + public global::Speechify.UpdateAgentTestFolderRequest? Type456 { get; set; } /// /// /// - public global::Speechify.RunTarget? Type457 { get; set; } + public global::Speechify.ListAgentTestRunsResponse? Type457 { get; set; } /// /// /// - public global::Speechify.TestRunConfigOverride? Type458 { get; set; } + public global::System.Collections.Generic.IList? Type458 { get; set; } /// /// /// - public global::Speechify.RunTargetedTestsRequest? Type459 { get; set; } + public global::Speechify.RunTarget? Type459 { get; set; } /// /// /// - public global::Speechify.SuiteRunTrigger? Type460 { get; set; } + public global::Speechify.TestRunConfigOverride? Type460 { get; set; } /// /// /// - public global::Speechify.AgentTestSuiteRunResults? Type461 { get; set; } + public global::Speechify.RunTargetedTestsRequest? Type461 { get; set; } /// /// /// - public global::Speechify.AgentTestSuiteRun? Type462 { get; set; } + public global::Speechify.SuiteRunTrigger? Type462 { get; set; } /// /// /// - public global::Speechify.RunAgentTestsResponse? Type463 { get; set; } + public global::Speechify.AgentTestSuiteRunResults? Type463 { get; set; } /// /// /// - public global::Speechify.BatchRunEntry? Type464 { get; set; } + public global::Speechify.AgentTestSuiteRun? Type464 { get; set; } /// /// /// - public global::Speechify.RunBatchRequest? Type465 { get; set; } + public global::Speechify.RunAgentTestsResponse? Type465 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type466 { get; set; } + public global::Speechify.BatchRunEntry? Type466 { get; set; } /// /// /// - public global::Speechify.ListSuiteRunsResponse? Type467 { get; set; } + public global::Speechify.RunBatchRequest? Type467 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type468 { get; set; } + public global::System.Collections.Generic.IList? Type468 { get; set; } /// /// /// - public global::Speechify.AgentTestSuiteRunWithRunsResults? Type469 { get; set; } + public global::Speechify.ListSuiteRunsResponse? Type469 { get; set; } /// /// /// - public global::Speechify.SuiteChildRun? Type470 { get; set; } + public global::System.Collections.Generic.IList? Type470 { get; set; } /// /// /// - public global::Speechify.AgentTestSuiteRunWithRuns? Type471 { get; set; } + public global::Speechify.AgentTestSuiteRunWithRunsResults? Type471 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type472 { get; set; } + public global::Speechify.SuiteChildRun? Type472 { get; set; } /// /// /// - public global::Speechify.RunAllTestsRequest? Type473 { get; set; } + public global::Speechify.AgentTestSuiteRunWithRuns? Type473 { get; set; } /// /// /// - public global::Speechify.TestStatsBucket? Type474 { get; set; } + public global::System.Collections.Generic.IList? Type474 { get; set; } /// /// /// - public global::Speechify.TestStats? Type475 { get; set; } + public global::Speechify.RunAllTestsRequest? Type475 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type476 { get; set; } + public global::Speechify.TestStatsBucket? Type476 { get; set; } /// /// /// - public global::System.Collections.Generic.Dictionary? Type477 { get; set; } + public global::Speechify.TestStats? Type477 { get; set; } /// /// /// - public global::Speechify.ShareLinkStatus? Type478 { get; set; } + public global::System.Collections.Generic.IList? Type478 { get; set; } /// /// /// - public global::Speechify.ShareLink? Type479 { get; set; } + public global::System.Collections.Generic.Dictionary? Type479 { get; set; } /// /// /// - public global::Speechify.ListShareLinksResponse? Type480 { get; set; } + public global::Speechify.ShareLinkStatus? Type480 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type481 { get; set; } + public global::Speechify.ShareLink? Type481 { get; set; } /// /// /// - public global::Speechify.CreateShareLinkRequest? Type482 { get; set; } + public global::Speechify.ListShareLinksResponse? Type482 { get; set; } /// /// /// - public global::Speechify.CreateShareLinkResponseStatus? Type483 { get; set; } + public global::System.Collections.Generic.IList? Type483 { get; set; } /// /// /// - public global::Speechify.CreateShareLinkResponse? Type484 { get; set; } + public global::Speechify.CreateShareLinkRequest? Type484 { get; set; } /// /// /// - public global::Speechify.RevealShareLinkTokenResponse? Type485 { get; set; } + public global::Speechify.CreateShareLinkResponseStatus? Type485 { get; set; } /// /// /// - public global::Speechify.ShareLinkPreview? Type486 { get; set; } + public global::Speechify.CreateShareLinkResponse? Type486 { get; set; } /// /// /// - public global::Speechify.CreateShareLinkSessionRequest? Type487 { get; set; } + public global::Speechify.RevealShareLinkTokenResponse? Type487 { get; set; } /// /// /// - public global::Speechify.ShareLinkSession? Type488 { get; set; } + public global::Speechify.ShareLinkPreview? Type488 { get; set; } /// /// /// - public global::Speechify.PhoneNumberProvider? Type489 { get; set; } + public global::Speechify.CreateShareLinkSessionRequest? Type489 { get; set; } /// /// /// - public global::Speechify.PhoneNumberCapability? Type490 { get; set; } + public global::Speechify.ShareLinkSession? Type490 { get; set; } /// /// /// - public global::Speechify.PhoneNumberReputationRisk? Type491 { get; set; } + public global::Speechify.PhoneNumberProvider? Type491 { get; set; } /// /// /// - public global::Speechify.PhoneNumberReputation? Type492 { get; set; } + public global::Speechify.PhoneNumberCapability? Type492 { get; set; } /// /// /// - public global::Speechify.PhoneNumber? Type493 { get; set; } + public global::Speechify.PhoneNumberReputationRisk? Type493 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type494 { get; set; } + public global::Speechify.PhoneNumberReputation? Type494 { get; set; } /// /// /// - public global::Speechify.ListPhoneNumbersResponse? Type495 { get; set; } + public global::Speechify.PhoneNumber? Type495 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type496 { get; set; } + public global::System.Collections.Generic.IList? Type496 { get; set; } /// /// /// - public global::Speechify.TwilioImportSpec? Type497 { get; set; } + public global::Speechify.ListPhoneNumbersResponse? Type497 { get; set; } /// /// /// - public global::Speechify.TelnyxImportSpec? Type498 { get; set; } + public global::System.Collections.Generic.IList? Type498 { get; set; } /// /// /// - public global::Speechify.ImportPhoneNumberRequest? Type499 { get; set; } + public global::Speechify.TwilioImportSpec? Type499 { get; set; } /// /// /// - public global::Speechify.PurchasedPhoneNumberProvider? Type500 { get; set; } + public global::Speechify.TelnyxImportSpec? Type500 { get; set; } /// /// /// - public global::Speechify.AvailablePhoneNumber? Type501 { get; set; } + public global::Speechify.ImportPhoneNumberRequest? Type501 { get; set; } /// /// /// - public global::Speechify.SearchAvailablePhoneNumbersResponse? Type502 { get; set; } + public global::Speechify.PurchasedPhoneNumberProvider? Type502 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type503 { get; set; } + public global::Speechify.AvailablePhoneNumber? Type503 { get; set; } /// /// /// - public global::Speechify.IntendedUseMarketingOrInformational? Type504 { get; set; } + public global::Speechify.SearchAvailablePhoneNumbersResponse? Type504 { get; set; } /// /// /// - public global::Speechify.IntendedUse? Type505 { get; set; } + public global::System.Collections.Generic.IList? Type505 { get; set; } /// /// /// - public global::Speechify.PurchasePhoneNumberRequest? Type506 { get; set; } + public global::Speechify.IntendedUseMarketingOrInformational? Type506 { get; set; } /// /// /// - public global::Speechify.UpdatePhoneNumberRequest? Type507 { get; set; } + public global::Speechify.IntendedUse? Type507 { get; set; } /// /// /// - public global::Speechify.CreateOutboundCallRequest? Type508 { get; set; } + public global::Speechify.PurchasePhoneNumberRequest? Type508 { get; set; } /// /// /// - public global::Speechify.CreateOutboundCallResponse? Type509 { get; set; } + public global::Speechify.UpdatePhoneNumberRequest? Type509 { get; set; } /// /// /// - public global::Speechify.BatchCall? Type510 { get; set; } + public global::Speechify.CreateOutboundCallRequest? Type510 { get; set; } /// /// /// - public global::Speechify.ListBatchCallsResponse? Type511 { get; set; } + public global::Speechify.CreateOutboundCallResponse? Type511 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type512 { get; set; } + public global::Speechify.BatchCall? Type512 { get; set; } /// /// /// - public global::Speechify.BatchRecipientRequest? Type513 { get; set; } + public global::Speechify.ListBatchCallsResponse? Type513 { get; set; } /// /// /// - public global::Speechify.CreateBatchCallRequest? Type514 { get; set; } + public global::System.Collections.Generic.IList? Type514 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type515 { get; set; } + public global::Speechify.BatchRecipientRequest? Type515 { get; set; } /// /// /// - public global::Speechify.BatchRecipientStatus? Type516 { get; set; } + public global::Speechify.CreateBatchCallRequest? Type516 { get; set; } /// /// /// - public global::Speechify.BatchRecipient? Type517 { get; set; } + public global::System.Collections.Generic.IList? Type517 { get; set; } /// /// /// - public global::Speechify.ListBatchRecipientsResponse? Type518 { get; set; } + public global::Speechify.BatchRecipientStatus? Type518 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type519 { get; set; } + public global::Speechify.BatchRecipient? Type519 { get; set; } /// /// /// - public global::Speechify.IvrMenuListEntryMenuTree? Type520 { get; set; } + public global::Speechify.ListBatchRecipientsResponse? Type520 { get; set; } /// /// /// - public global::Speechify.IVRMenuListEntry? Type521 { get; set; } + public global::System.Collections.Generic.IList? Type521 { get; set; } /// /// /// - public global::Speechify.ListIVRMenusResponse? Type522 { get; set; } + public global::Speechify.IvrMenuListEntryMenuTree? Type522 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type523 { get; set; } + public global::Speechify.IVRMenuListEntry? Type523 { get; set; } /// /// /// - public global::Speechify.IvrMenuMenuTree? Type524 { get; set; } + public global::Speechify.ListIVRMenusResponse? Type524 { get; set; } /// /// /// - public global::Speechify.IVRMenu? Type525 { get; set; } + public global::System.Collections.Generic.IList? Type525 { get; set; } /// /// /// - public global::Speechify.UpdateIVRMenuLabelRequest? Type526 { get; set; } + public global::Speechify.IvrMenuMenuTree? Type526 { get; set; } /// /// /// - public global::Speechify.InvalidateIVRMenuRequest? Type527 { get; set; } + public global::Speechify.IVRMenu? Type527 { get; set; } /// /// /// - public global::Speechify.SIPTrunkProvider? Type528 { get; set; } + public global::Speechify.UpdateIVRMenuLabelRequest? Type528 { get; set; } /// /// /// - public global::Speechify.SIPTrunkDirection? Type529 { get; set; } + public global::Speechify.InvalidateIVRMenuRequest? Type529 { get; set; } /// /// /// - public global::Speechify.SIPTransport? Type530 { get; set; } + public global::Speechify.SIPTrunkProvider? Type530 { get; set; } /// /// /// - public global::Speechify.SIPMediaEncryption? Type531 { get; set; } + public global::Speechify.SIPTrunkDirection? Type531 { get; set; } /// /// /// - public global::Speechify.SIPTrunk? Type532 { get; set; } + public global::Speechify.SIPTransport? Type532 { get; set; } /// /// /// - public global::Speechify.ListSIPTrunksResponse? Type533 { get; set; } + public global::Speechify.SIPMediaEncryption? Type533 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type534 { get; set; } + public global::Speechify.SIPTrunk? Type534 { get; set; } /// /// /// - public global::Speechify.CreateSipTrunkRequestCredentials? Type535 { get; set; } + public global::Speechify.ListSIPTrunksResponse? Type535 { get; set; } /// /// /// - public global::Speechify.CreateSIPTrunkRequest? Type536 { get; set; } + public global::System.Collections.Generic.IList? Type536 { get; set; } /// /// /// - public global::Speechify.Caller? Type537 { get; set; } + public global::Speechify.CreateSipTrunkRequestCredentials? Type537 { get; set; } /// /// /// - public global::Speechify.ListCallersResponse? Type538 { get; set; } + public global::Speechify.CreateSIPTrunkRequest? Type538 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type539 { get; set; } + public global::Speechify.Caller? Type539 { get; set; } /// /// /// - public global::Speechify.UpdateCallerRequest? Type540 { get; set; } + public global::Speechify.ListCallersResponse? Type540 { get; set; } /// /// /// - public global::Speechify.DeleteCallerResponse? Type541 { get; set; } + public global::System.Collections.Generic.IList? Type541 { get; set; } /// /// /// - public global::Speechify.ListCallerConversationsResponse? Type542 { get; set; } + public global::Speechify.UpdateCallerRequest? Type542 { get; set; } /// /// /// - public global::Speechify.ListCallerMemoriesResponse? Type543 { get; set; } + public global::Speechify.DeleteCallerResponse? Type543 { get; set; } /// /// /// - public global::Speechify.AudioAsset? Type544 { get; set; } + public global::Speechify.ListCallerConversationsResponse? Type544 { get; set; } /// /// /// - public global::Speechify.ListAudioAssetsResponse? Type545 { get; set; } + public global::Speechify.ListCallerMemoriesResponse? Type545 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type546 { get; set; } + public global::Speechify.AudioAsset? Type546 { get; set; } /// /// /// - public global::Speechify.TeamMember? Type547 { get; set; } + public global::Speechify.ListAudioAssetsResponse? Type547 { get; set; } /// /// /// - public global::Speechify.Team? Type548 { get; set; } + public global::System.Collections.Generic.IList? Type548 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type549 { get; set; } + public global::Speechify.TeamMember? Type549 { get; set; } /// /// /// - public global::Speechify.ListTeamsResponse? Type550 { get; set; } + public global::Speechify.Team? Type550 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type551 { get; set; } + public global::System.Collections.Generic.IList? Type551 { get; set; } /// /// /// - public global::Speechify.TeamMemberInput? Type552 { get; set; } + public global::Speechify.ListTeamsResponse? Type552 { get; set; } /// /// /// - public global::Speechify.CreateTeamRequest? Type553 { get; set; } + public global::System.Collections.Generic.IList? Type553 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type554 { get; set; } + public global::Speechify.TeamMemberInput? Type554 { get; set; } /// /// /// - public global::Speechify.UpdateTeamRequest? Type555 { get; set; } + public global::Speechify.CreateTeamRequest? Type555 { get; set; } /// /// /// - public global::Speechify.CreateTeamRunRequest? Type556 { get; set; } + public global::System.Collections.Generic.IList? Type556 { get; set; } /// /// /// - public global::Speechify.AgentTriggerType? Type557 { get; set; } + public global::Speechify.UpdateTeamRequest? Type557 { get; set; } /// /// /// - public global::Speechify.TriggerRunSpec? Type558 { get; set; } + public global::Speechify.CreateTeamRunRequest? Type558 { get; set; } /// /// /// - public global::Speechify.TriggerScheduleConfig? Type559 { get; set; } + public global::Speechify.AgentTriggerType? Type559 { get; set; } /// /// /// - public global::Speechify.TriggerWebhookConfigUserIdentitySource? Type560 { get; set; } + public global::Speechify.TriggerRunSpec? Type560 { get; set; } /// /// /// - public global::Speechify.TriggerWebhookConfig? Type561 { get; set; } + public global::Speechify.TriggerScheduleConfig? Type561 { get; set; } /// /// /// - public global::Speechify.AgentTriggerLastFireStatus? Type562 { get; set; } + public global::Speechify.TriggerWebhookConfigUserIdentitySource? Type562 { get; set; } /// /// /// - public global::Speechify.AgentTrigger? Type563 { get; set; } + public global::Speechify.TriggerWebhookConfig? Type563 { get; set; } /// /// /// - public global::Speechify.ListAgentTriggersResponse? Type564 { get; set; } + public global::Speechify.AgentTriggerLastFireStatus? Type564 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type565 { get; set; } + public global::Speechify.AgentTrigger? Type565 { get; set; } /// /// /// - public global::Speechify.CreateAgentTriggerRequestType? Type566 { get; set; } + public global::Speechify.ListAgentTriggersResponse? Type566 { get; set; } /// /// /// - public global::Speechify.CreateAgentTriggerRequest? Type567 { get; set; } + public global::System.Collections.Generic.IList? Type567 { get; set; } /// /// /// - public global::Speechify.UpdateAgentTriggerRequest? Type568 { get; set; } + public global::Speechify.CreateAgentTriggerRequestType? Type568 { get; set; } /// /// /// - public global::Speechify.AgentTriggerFireResponseStatus? Type569 { get; set; } + public global::Speechify.CreateAgentTriggerRequest? Type569 { get; set; } /// /// /// - public global::Speechify.AgentTriggerFireResponse? Type570 { get; set; } + public global::Speechify.UpdateAgentTriggerRequest? Type570 { get; set; } /// /// /// - public global::Speechify.Skill? Type571 { get; set; } + public global::Speechify.AgentTriggerFireResponseStatus? Type571 { get; set; } /// /// /// - public global::Speechify.ListSkillsResponse? Type572 { get; set; } + public global::Speechify.AgentTriggerFireResponse? Type572 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type573 { get; set; } + public global::Speechify.Skill? Type573 { get; set; } /// /// /// - public global::Speechify.CreateSkillRequest? Type574 { get; set; } + public global::Speechify.ListSkillsResponse? Type574 { get; set; } /// /// /// - public global::Speechify.UpdateSkillRequest? Type575 { get; set; } + public global::System.Collections.Generic.IList? Type575 { get; set; } /// /// /// - public global::Speechify.SkillVersion? Type576 { get; set; } + public global::Speechify.CreateSkillRequest? Type576 { get; set; } /// /// /// - public global::Speechify.ListSkillVersionsResponse? Type577 { get; set; } + public global::Speechify.UpdateSkillRequest? Type577 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type578 { get; set; } + public global::Speechify.SkillVersion? Type578 { get; set; } /// /// /// - public global::Speechify.AgentSkill? Type579 { get; set; } + public global::Speechify.ListSkillVersionsResponse? Type579 { get; set; } /// /// /// - public global::Speechify.ListAgentSkillsResponse? Type580 { get; set; } + public global::System.Collections.Generic.IList? Type580 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type581 { get; set; } + public global::Speechify.AgentSkill? Type581 { get; set; } /// /// /// - public global::Speechify.AttachSkillRequest? Type582 { get; set; } + public global::Speechify.ListAgentSkillsResponse? Type582 { get; set; } /// /// /// - public global::Speechify.UpdateAgentSkillRequest? Type583 { get; set; } + public global::System.Collections.Generic.IList? Type583 { get; set; } /// /// /// - public global::Speechify.V1FilesGetParametersKind? Type584 { get; set; } + public global::Speechify.AttachSkillRequest? Type584 { get; set; } /// /// /// - public global::Speechify.FileKind? Type585 { get; set; } + public global::Speechify.UpdateAgentSkillRequest? Type585 { get; set; } /// /// /// - public global::Speechify.FileSource? Type586 { get; set; } + public global::Speechify.V1FilesGetParametersKind? Type586 { get; set; } /// /// /// - public global::Speechify.File? Type587 { get; set; } + public global::Speechify.FileKind? Type587 { get; set; } /// /// /// - public global::Speechify.ListFilesResponse? Type588 { get; set; } + public global::Speechify.FileSource? Type588 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type589 { get; set; } + public global::Speechify.File? Type589 { get; set; } /// /// /// - public global::Speechify.V1FilesPostRequestBodyContentMultipartFormDataSchemaKind? Type590 { get; set; } + public global::Speechify.ListFilesResponse? Type590 { get; set; } /// /// /// - public global::Speechify.Store? Type591 { get; set; } + public global::System.Collections.Generic.IList? Type591 { get; set; } /// /// /// - public global::Speechify.ListStoresResponse? Type592 { get; set; } + public global::Speechify.V1FilesPostRequestBodyContentMultipartFormDataSchemaKind? Type592 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type593 { get; set; } + public global::Speechify.Store? Type593 { get; set; } /// /// /// - public global::Speechify.CreateStoreRequest? Type594 { get; set; } + public global::Speechify.ListStoresResponse? Type594 { get; set; } /// /// /// - public global::Speechify.UpdateStoreRequest? Type595 { get; set; } + public global::System.Collections.Generic.IList? Type595 { get; set; } /// /// /// - public global::Speechify.StoreCollection? Type596 { get; set; } + public global::Speechify.CreateStoreRequest? Type596 { get; set; } /// /// /// - public global::Speechify.ListStoreCollectionsResponse? Type597 { get; set; } + public global::Speechify.UpdateStoreRequest? Type597 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type598 { get; set; } + public global::Speechify.StoreCollection? Type598 { get; set; } /// /// /// - public global::Speechify.StoreDocumentSource? Type599 { get; set; } + public global::Speechify.ListStoreCollectionsResponse? Type599 { get; set; } /// /// /// - public global::Speechify.StoreDocument? Type600 { get; set; } + public global::System.Collections.Generic.IList? Type600 { get; set; } /// /// /// - public global::Speechify.QueryStoreDocumentsResponse? Type601 { get; set; } + public global::Speechify.StoreDocumentSource? Type601 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type602 { get; set; } + public global::Speechify.StoreDocument? Type602 { get; set; } /// /// /// - public global::Speechify.WriteStoreDocumentRequest? Type603 { get; set; } + public global::Speechify.QueryStoreDocumentsResponse? Type603 { get; set; } /// /// /// - public global::Speechify.StoreWhereClauseOp? Type604 { get; set; } + public global::System.Collections.Generic.IList? Type604 { get; set; } /// /// /// - public global::Speechify.StoreWhereClause? Type605 { get; set; } + public global::Speechify.WriteStoreDocumentRequest? Type605 { get; set; } /// /// /// - public global::Speechify.StoreOrderByDirection? Type606 { get; set; } + public global::Speechify.StoreWhereClauseOp? Type606 { get; set; } /// /// /// - public global::Speechify.StoreOrderBy? Type607 { get; set; } + public global::Speechify.StoreWhereClause? Type607 { get; set; } /// /// /// - public global::Speechify.StoreDocumentQuery? Type608 { get; set; } + public global::Speechify.StoreOrderByDirection? Type608 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type609 { get; set; } + public global::Speechify.StoreOrderBy? Type609 { get; set; } /// /// /// - public global::Speechify.StoreAggregateMetricOp? Type610 { get; set; } + public global::Speechify.StoreDocumentQuery? Type610 { get; set; } /// /// /// - public global::Speechify.StoreAggregateMetric? Type611 { get; set; } + public global::System.Collections.Generic.IList? Type611 { get; set; } /// /// /// - public global::Speechify.StoreAggregateQuery? Type612 { get; set; } + public global::Speechify.StoreAggregateMetricOp? Type612 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type613 { get; set; } + public global::Speechify.StoreAggregateMetric? Type613 { get; set; } /// /// /// - public global::Speechify.StoreAggregateGroup? Type614 { get; set; } + public global::Speechify.StoreAggregateQuery? Type614 { get; set; } /// /// /// - public global::System.Collections.Generic.Dictionary? Type615 { get; set; } + public global::System.Collections.Generic.IList? Type615 { get; set; } /// /// /// - public global::Speechify.StoreAggregateResponse? Type616 { get; set; } + public global::Speechify.StoreAggregateGroup? Type616 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type617 { get; set; } + public global::System.Collections.Generic.Dictionary? Type617 { get; set; } /// /// /// - public global::Speechify.StoreBatchWriteOp? Type618 { get; set; } + public global::Speechify.StoreAggregateResponse? Type618 { get; set; } /// /// /// - public global::Speechify.StoreBatchWrite? Type619 { get; set; } + public global::System.Collections.Generic.IList? Type619 { get; set; } /// /// /// - public global::Speechify.StoreBatchRequest? Type620 { get; set; } + public global::Speechify.StoreBatchWriteOp? Type620 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type621 { get; set; } + public global::Speechify.StoreBatchWrite? Type621 { get; set; } /// /// /// - public global::Speechify.StoreBatchResultOp? Type622 { get; set; } + public global::Speechify.StoreBatchRequest? Type622 { get; set; } /// /// /// - public global::Speechify.StoreBatchResult? Type623 { get; set; } + public global::System.Collections.Generic.IList? Type623 { get; set; } /// /// /// - public global::Speechify.StoreBatchResponse? Type624 { get; set; } + public global::Speechify.StoreBatchResultOp? Type624 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type625 { get; set; } + public global::Speechify.StoreBatchResult? Type625 { get; set; } /// /// /// - public global::Speechify.ListAgentStoresResponse? Type626 { get; set; } + public global::Speechify.StoreBatchResponse? Type626 { get; set; } /// /// /// - public global::Speechify.HostedApiAuthMode? Type627 { get; set; } + public global::System.Collections.Generic.IList? Type627 { get; set; } /// /// /// - public global::Speechify.HostedAPI? Type628 { get; set; } + public global::Speechify.ListAgentStoresResponse? Type628 { get; set; } /// /// /// - public global::Speechify.ListHostedAPIsResponse? Type629 { get; set; } + public global::Speechify.HostedApiAuthMode? Type629 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type630 { get; set; } + public global::Speechify.HostedAPI? Type630 { get; set; } /// /// /// - public global::Speechify.CreateHostedApiRequestAuthMode? Type631 { get; set; } + public global::Speechify.ListHostedAPIsResponse? Type631 { get; set; } /// /// /// - public global::Speechify.CreateHostedAPIRequest? Type632 { get; set; } + public global::System.Collections.Generic.IList? Type632 { get; set; } /// /// /// - public global::Speechify.UpdateHostedApiRequestAuthMode? Type633 { get; set; } + public global::Speechify.CreateHostedApiRequestAuthMode? Type633 { get; set; } /// /// /// - public global::Speechify.UpdateHostedAPIRequest? Type634 { get; set; } + public global::Speechify.CreateHostedAPIRequest? Type634 { get; set; } /// /// /// - public global::Speechify.HostedApiUsageRoutesItems? Type635 { get; set; } + public global::Speechify.UpdateHostedApiRequestAuthMode? Type635 { get; set; } /// /// /// - public global::Speechify.HostedAPIUsage? Type636 { get; set; } + public global::Speechify.UpdateHostedAPIRequest? Type636 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type637 { get; set; } + public global::Speechify.HostedApiUsageRoutesItems? Type637 { get; set; } /// /// /// - public global::Speechify.HostedApiRouteMethod? Type638 { get; set; } + public global::Speechify.HostedAPIUsage? Type638 { get; set; } /// /// /// - public global::Speechify.HostedApiResolverType? Type639 { get; set; } + public global::System.Collections.Generic.IList? Type639 { get; set; } /// /// /// - public global::Speechify.HostedApiResolverWhereItemsOp? Type640 { get; set; } + public global::Speechify.HostedApiRouteMethod? Type640 { get; set; } /// /// /// - public global::Speechify.HostedApiResolverWhereItems? Type641 { get; set; } + public global::Speechify.HostedApiResolverType? Type641 { get; set; } /// /// /// - public global::Speechify.HostedApiResolverOrderByDirection? Type642 { get; set; } + public global::Speechify.HostedApiResolverWriteMode? Type642 { get; set; } /// /// /// - public global::Speechify.HostedApiResolverOrderBy? Type643 { get; set; } + public global::Speechify.HostedApiResolverWhereItemsOp? Type643 { get; set; } /// /// /// - public global::Speechify.HostedAPIResolver? Type644 { get; set; } + public global::Speechify.HostedApiResolverWhereItems? Type644 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type645 { get; set; } + public global::Speechify.HostedApiResolverOrderByDirection? Type645 { get; set; } /// /// /// - public global::Speechify.HostedAPIRoute? Type646 { get; set; } + public global::Speechify.HostedApiResolverOrderBy? Type646 { get; set; } /// /// /// - public global::Speechify.ListHostedAPIRoutesResponse? Type647 { get; set; } + public global::Speechify.HostedAPIResolver? Type647 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type648 { get; set; } + public global::System.Collections.Generic.IList? Type648 { get; set; } /// /// /// - public global::Speechify.CreateHostedApiRouteRequestMethod? Type649 { get; set; } + public global::Speechify.HostedAPIRoute? Type649 { get; set; } /// /// /// - public global::Speechify.CreateHostedAPIRouteRequest? Type650 { get; set; } + public global::Speechify.ListHostedAPIRoutesResponse? Type650 { get; set; } /// /// /// - public global::Speechify.UpdateHostedApiRouteRequestMethod? Type651 { get; set; } + public global::System.Collections.Generic.IList? Type651 { get; set; } /// /// /// - public global::Speechify.UpdateHostedAPIRouteRequest? Type652 { get; set; } + public global::Speechify.CreateHostedApiRouteRequestMethod? Type652 { get; set; } /// /// /// - public global::Speechify.HostedAPIKey? Type653 { get; set; } + public global::Speechify.CreateHostedAPIRouteRequest? Type653 { get; set; } /// /// /// - public global::Speechify.ListHostedAPIKeysResponse? Type654 { get; set; } + public global::Speechify.UpdateHostedApiRouteRequestMethod? Type654 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type655 { get; set; } + public global::Speechify.UpdateHostedAPIRouteRequest? Type655 { get; set; } /// /// /// - public global::Speechify.CreateHostedAPIKeyRequest? Type656 { get; set; } + public global::Speechify.HostedAPIKey? Type656 { get; set; } /// /// /// - public global::Speechify.HostedAPIUserTokenSecret? Type657 { get; set; } + public global::Speechify.ListHostedAPIKeysResponse? Type657 { get; set; } /// /// /// - public global::Speechify.ContactIdentifierKind? Type658 { get; set; } + public global::System.Collections.Generic.IList? Type658 { get; set; } /// /// /// - public global::Speechify.ContactIdentifierAssertedBy? Type659 { get; set; } + public global::Speechify.CreateHostedAPIKeyRequest? Type659 { get; set; } /// /// /// - public global::Speechify.ContactIdentifier? Type660 { get; set; } + public global::Speechify.HostedAPIUserTokenSecret? Type660 { get; set; } /// /// /// - public global::Speechify.Contact? Type661 { get; set; } + public global::Speechify.ContactIdentifierKind? Type661 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type662 { get; set; } + public global::Speechify.ContactIdentifierAssertedBy? Type662 { get; set; } /// /// /// - public global::Speechify.ListContactsResponse? Type663 { get; set; } + public global::Speechify.ContactIdentifier? Type663 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type664 { get; set; } + public global::Speechify.Contact? Type664 { get; set; } /// /// /// - public global::Speechify.UpdateContactRequest? Type665 { get; set; } + public global::System.Collections.Generic.IList? Type665 { get; set; } /// /// /// - public global::Speechify.DeleteContactResponse? Type666 { get; set; } + public global::Speechify.ListContactsResponse? Type666 { get; set; } /// /// /// - public global::Speechify.AttachContactIdentifierRequestKind? Type667 { get; set; } + public global::System.Collections.Generic.IList? Type667 { get; set; } /// /// /// - public global::Speechify.AttachContactIdentifierRequest? Type668 { get; set; } + public global::Speechify.UpdateContactRequest? Type668 { get; set; } /// /// /// - public global::Speechify.MergeContactsRequest? Type669 { get; set; } + public global::Speechify.DeleteContactResponse? Type669 { get; set; } /// /// /// - public global::Speechify.MergeContactsResponseMerged? Type670 { get; set; } + public global::Speechify.AttachContactIdentifierRequestKind? Type670 { get; set; } /// /// /// - public global::Speechify.MergeContactsResponse? Type671 { get; set; } + public global::Speechify.AttachContactIdentifierRequest? Type671 { get; set; } /// /// /// - public global::Speechify.BillingEntitlementsMaxLlmModelClass? Type672 { get; set; } + public global::Speechify.MergeContactsRequest? Type672 { get; set; } /// /// /// - public global::Speechify.BillingEntitlements? Type673 { get; set; } + public global::Speechify.MergeContactsResponseMerged? Type673 { get; set; } /// /// /// - public global::Speechify.EntitlementsResponse? Type674 { get; set; } + public global::Speechify.MergeContactsResponse? Type674 { get; set; } /// /// /// - public global::System.Collections.Generic.Dictionary? Type675 { get; set; } + public global::Speechify.BillingEntitlementsMaxLlmModelClass? Type675 { get; set; } /// /// /// - public global::Speechify.ContactResolver? Type676 { get; set; } + public global::Speechify.BillingEntitlements? Type676 { get; set; } /// /// /// - public global::Speechify.PutContactResolverRequest? Type677 { get; set; } + public global::Speechify.EntitlementsResponse? Type677 { get; set; } /// /// /// - public global::Speechify.WebhookEndpoint? Type678 { get; set; } + public global::System.Collections.Generic.Dictionary? Type678 { get; set; } /// /// /// - public global::Speechify.ListWebhookEndpointsResponse? Type679 { get; set; } + public global::Speechify.ContactResolver? Type679 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type680 { get; set; } + public global::Speechify.PutContactResolverRequest? Type680 { get; set; } /// /// /// - public global::Speechify.CreateWebhookEndpointRequest? Type681 { get; set; } + public global::Speechify.WebhookEndpoint? Type681 { get; set; } /// /// /// - public global::Speechify.UpdateWebhookEndpointRequest? Type682 { get; set; } + public global::Speechify.ListWebhookEndpointsResponse? Type682 { get; set; } /// /// /// - public global::Speechify.WebhookEndpointDelivery? Type683 { get; set; } + public global::System.Collections.Generic.IList? Type683 { get; set; } /// /// /// - public global::Speechify.ListWebhookEndpointDeliveriesResponse? Type684 { get; set; } + public global::Speechify.CreateWebhookEndpointRequest? Type684 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type685 { get; set; } + public global::Speechify.UpdateWebhookEndpointRequest? Type685 { get; set; } /// /// /// - public global::Speechify.Project? Type686 { get; set; } + public global::Speechify.WebhookEndpointDelivery? Type686 { get; set; } /// /// /// - public global::Speechify.ListProjectsResponse? Type687 { get; set; } + public global::Speechify.ListWebhookEndpointDeliveriesResponse? Type687 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type688 { get; set; } + public global::System.Collections.Generic.IList? Type688 { get; set; } /// /// /// - public global::Speechify.CreateProjectRequest? Type689 { get; set; } + public global::Speechify.Project? Type689 { get; set; } /// /// /// - public global::Speechify.UpdateProjectRequest? Type690 { get; set; } + public global::Speechify.ListProjectsResponse? Type690 { get; set; } /// /// /// - public global::Speechify.DeleteProjectRequestMode? Type691 { get; set; } + public global::System.Collections.Generic.IList? Type691 { get; set; } /// /// /// - public global::Speechify.DeleteProjectRequest? Type692 { get; set; } + public global::Speechify.CreateProjectRequest? Type692 { get; set; } /// /// /// - public global::Speechify.ProjectRestoredCounts? Type693 { get; set; } + public global::Speechify.UpdateProjectRequest? Type693 { get; set; } /// /// /// - public global::Speechify.ProjectStillRevokedCounts? Type694 { get; set; } + public global::Speechify.DeleteProjectRequestMode? Type694 { get; set; } /// /// /// - public global::Speechify.ProjectRestore? Type695 { get; set; } + public global::Speechify.DeleteProjectRequest? Type695 { get; set; } /// /// /// - public global::Speechify.ProjectTeardownBlockerKind? Type696 { get; set; } + public global::Speechify.ProjectRestoredCounts? Type696 { get; set; } /// /// /// - public global::Speechify.ProjectTeardownBlockerBlocksItems? Type697 { get; set; } + public global::Speechify.ProjectStillRevokedCounts? Type697 { get; set; } /// /// /// - public global::Speechify.ProjectTeardownBlocker? Type698 { get; set; } + public global::Speechify.ProjectRestore? Type698 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type699 { get; set; } + public global::Speechify.ProjectTeardownBlockerKind? Type699 { get; set; } /// /// /// - public global::Speechify.ProjectTeardownGroup? Type700 { get; set; } + public global::Speechify.ProjectTeardownBlockerBlocksItems? Type700 { get; set; } /// /// /// - public global::Speechify.ProjectTeardown? Type701 { get; set; } + public global::Speechify.ProjectTeardownBlocker? Type701 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type702 { get; set; } + public global::System.Collections.Generic.IList? Type702 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type703 { get; set; } + public global::Speechify.ProjectTeardownGroup? Type703 { get; set; } /// /// /// - public global::Speechify.ProjectResourceCounts? Type704 { get; set; } + public global::Speechify.ProjectTeardown? Type704 { get; set; } /// /// /// - public global::Speechify.ProjectStats? Type705 { get; set; } + public global::System.Collections.Generic.IList? Type705 { get; set; } /// /// /// - public global::Speechify.PromoteProjectRequest? Type706 { get; set; } + public global::System.Collections.Generic.IList? Type706 { get; set; } /// /// /// - public global::Speechify.PromoteCreated? Type707 { get; set; } + public global::Speechify.ProjectResourceCounts? Type707 { get; set; } /// /// /// - public global::Speechify.PromoteReused? Type708 { get; set; } + public global::Speechify.ProjectStats? Type708 { get; set; } /// /// /// - public global::Speechify.PromoteAttentionKind? Type709 { get; set; } + public global::Speechify.PromoteProjectRequest? Type709 { get; set; } /// /// /// - public global::Speechify.PromoteAttentionReason? Type710 { get; set; } + public global::Speechify.PromoteCreated? Type710 { get; set; } /// /// /// - public global::Speechify.PromoteAttention? Type711 { get; set; } + public global::Speechify.PromoteReused? Type711 { get; set; } /// /// /// - public global::Speechify.PromoteProjectResponse? Type712 { get; set; } + public global::Speechify.PromoteAttentionKind? Type712 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type713 { get; set; } + public global::Speechify.PromoteAttentionReason? Type713 { get; set; } /// /// /// - public global::Speechify.ProjectAuditEventType? Type714 { get; set; } + public global::Speechify.PromoteAttention? Type714 { get; set; } /// /// /// - public global::Speechify.ProjectAuditEvent? Type715 { get; set; } + public global::Speechify.PromoteProjectResponse? Type715 { get; set; } /// /// /// - public global::Speechify.ProjectAuditResponse? Type716 { get; set; } + public global::System.Collections.Generic.IList? Type716 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type717 { get; set; } + public global::Speechify.ProjectAuditEventType? Type717 { get; set; } /// /// /// - public global::Speechify.ProjectMember? Type718 { get; set; } + public global::Speechify.ProjectAuditEvent? Type718 { get; set; } /// /// /// - public global::Speechify.ProjectMembersResponse? Type719 { get; set; } + public global::Speechify.ProjectAuditResponse? Type719 { get; set; } /// /// /// - public global::System.Collections.Generic.IList? Type720 { get; set; } + public global::System.Collections.Generic.IList? Type720 { get; set; } /// /// /// - public global::Speechify.GrantProjectMemberRequest? Type721 { get; set; } + public global::Speechify.ProjectMember? Type721 { get; set; } /// /// /// - public global::Speechify.CreateRequest? Type722 { get; set; } + public global::Speechify.ProjectMembersResponse? Type722 { get; set; } /// /// /// - public global::Speechify.DetectRequest? Type723 { get; set; } + public global::System.Collections.Generic.IList? Type723 { get; set; } /// /// /// - public global::Speechify.VerifyRequest? Type724 { get; set; } + public global::Speechify.GrantProjectMemberRequest? Type724 { get; set; } /// /// /// - public global::Speechify.UploadDocumentRequest? Type725 { get; set; } + public global::Speechify.CreateRequest? Type725 { get; set; } /// /// /// - public global::Speechify.UpdateDocumentRequest? Type726 { get; set; } + public global::Speechify.DetectRequest? Type726 { get; set; } /// /// /// - public global::Speechify.RunTestRequest? Type727 { get; set; } + public global::Speechify.VerifyRequest? Type727 { get; set; } /// /// /// - public global::Speechify.UploadRequest? Type728 { get; set; } + public global::Speechify.UploadDocumentRequest? Type728 { get; set; } /// /// /// - public global::Speechify.UploadRequest2? Type729 { get; set; } + public global::Speechify.UpdateDocumentRequest? Type729 { get; set; } + /// + /// + /// + public global::Speechify.RunTestRequest? Type730 { get; set; } + /// + /// + /// + public global::Speechify.UploadRequest? Type731 { get; set; } + /// + /// + /// + public global::Speechify.UploadRequest2? Type732 { get; set; } /// /// @@ -3214,254 +3226,258 @@ public sealed partial class JsonSerializerContextTypes /// /// /// - public global::System.Collections.Generic.List? ListType65 { get; set; } + public global::System.Collections.Generic.List? ListType65 { get; set; } + /// + /// + /// + public global::System.Collections.Generic.List? ListType66 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType66 { get; set; } + public global::System.Collections.Generic.List? ListType67 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType67 { get; set; } + public global::System.Collections.Generic.List? ListType68 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType68 { get; set; } + public global::System.Collections.Generic.List? ListType69 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType69 { get; set; } + public global::System.Collections.Generic.List? ListType70 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType70 { get; set; } + public global::System.Collections.Generic.List? ListType71 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType71 { get; set; } + public global::System.Collections.Generic.List? ListType72 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType72 { get; set; } + public global::System.Collections.Generic.List? ListType73 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType73 { get; set; } + public global::System.Collections.Generic.List? ListType74 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType74 { get; set; } + public global::System.Collections.Generic.List? ListType75 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType75 { get; set; } + public global::System.Collections.Generic.List? ListType76 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType76 { get; set; } + public global::System.Collections.Generic.List? ListType77 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType77 { get; set; } + public global::System.Collections.Generic.List? ListType78 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType78 { get; set; } + public global::System.Collections.Generic.List? ListType79 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType79 { get; set; } + public global::System.Collections.Generic.List? ListType80 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType80 { get; set; } + public global::System.Collections.Generic.List? ListType81 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType81 { get; set; } + public global::System.Collections.Generic.List? ListType82 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType82 { get; set; } + public global::System.Collections.Generic.List? ListType83 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType83 { get; set; } + public global::System.Collections.Generic.List? ListType84 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType84 { get; set; } + public global::System.Collections.Generic.List? ListType85 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType85 { get; set; } + public global::System.Collections.Generic.List? ListType86 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType86 { get; set; } + public global::System.Collections.Generic.List? ListType87 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType87 { get; set; } + public global::System.Collections.Generic.List? ListType88 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType88 { get; set; } + public global::System.Collections.Generic.List? ListType89 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType89 { get; set; } + public global::System.Collections.Generic.List? ListType90 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType90 { get; set; } + public global::System.Collections.Generic.List? ListType91 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType91 { get; set; } + public global::System.Collections.Generic.List? ListType92 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType92 { get; set; } + public global::System.Collections.Generic.List? ListType93 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType93 { get; set; } + public global::System.Collections.Generic.List? ListType94 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType94 { get; set; } + public global::System.Collections.Generic.List? ListType95 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType95 { get; set; } + public global::System.Collections.Generic.List? ListType96 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType96 { get; set; } + public global::System.Collections.Generic.List? ListType97 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType97 { get; set; } + public global::System.Collections.Generic.List? ListType98 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType98 { get; set; } + public global::System.Collections.Generic.List? ListType99 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType99 { get; set; } + public global::System.Collections.Generic.List? ListType100 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType100 { get; set; } + public global::System.Collections.Generic.List? ListType101 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType101 { get; set; } + public global::System.Collections.Generic.List? ListType102 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType102 { get; set; } + public global::System.Collections.Generic.List? ListType103 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType103 { get; set; } + public global::System.Collections.Generic.List? ListType104 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType104 { get; set; } + public global::System.Collections.Generic.List? ListType105 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType105 { get; set; } + public global::System.Collections.Generic.List? ListType106 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType106 { get; set; } + public global::System.Collections.Generic.List? ListType107 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType107 { get; set; } + public global::System.Collections.Generic.List? ListType108 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType108 { get; set; } + public global::System.Collections.Generic.List? ListType109 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType109 { get; set; } + public global::System.Collections.Generic.List? ListType110 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType110 { get; set; } + public global::System.Collections.Generic.List? ListType111 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType111 { get; set; } + public global::System.Collections.Generic.List? ListType112 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType112 { get; set; } + public global::System.Collections.Generic.List? ListType113 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType113 { get; set; } + public global::System.Collections.Generic.List? ListType114 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType114 { get; set; } + public global::System.Collections.Generic.List? ListType115 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType115 { get; set; } + public global::System.Collections.Generic.List? ListType116 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType116 { get; set; } + public global::System.Collections.Generic.List? ListType117 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType117 { get; set; } + public global::System.Collections.Generic.List? ListType118 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType118 { get; set; } + public global::System.Collections.Generic.List? ListType119 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType119 { get; set; } + public global::System.Collections.Generic.List? ListType120 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType120 { get; set; } + public global::System.Collections.Generic.List? ListType121 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType121 { get; set; } + public global::System.Collections.Generic.List? ListType122 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType122 { get; set; } + public global::System.Collections.Generic.List? ListType123 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType123 { get; set; } + public global::System.Collections.Generic.List? ListType124 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType124 { get; set; } + public global::System.Collections.Generic.List? ListType125 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType125 { get; set; } + public global::System.Collections.Generic.List? ListType126 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType126 { get; set; } + public global::System.Collections.Generic.List? ListType127 { get; set; } /// /// /// - public global::System.Collections.Generic.List? ListType127 { get; set; } + public global::System.Collections.Generic.List? ListType128 { get; set; } } } \ No newline at end of file diff --git a/src/libs/Speechify/Generated/Speechify.Models.AgentTool.g.cs b/src/libs/Speechify/Generated/Speechify.Models.AgentTool.g.cs index c4466bd5..2b233b94 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.AgentTool.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.AgentTool.g.cs @@ -111,6 +111,16 @@ public sealed partial class AgentTool [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Speechify.JsonConverters.ToolApprovalClassJsonConverter))] public global::Speechify.ToolApprovalClass? EffectiveApproval { get; set; } + /// + /// Where a call to this tool can execute (see `reach` on `Tool`).
+ /// Read-only, and absent for a `builtin`: a built-in's reach is a
+ /// property of the capability rather than of the kind, and is
+ /// published as `voice_only` / `runs_only` on
+ /// `GET /v1/agents/tool-capabilities`. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("reach")] + public global::System.Collections.Generic.IList? Reach { get; set; } + /// /// /// @@ -183,6 +193,13 @@ public sealed partial class AgentTool /// you set `enabled: false`. Absent for a built-in the worker runs,
/// which only ever fires inside a live session. /// + /// + /// Where a call to this tool can execute (see `reach` on `Tool`).
+ /// Read-only, and absent for a `builtin`: a built-in's reach is a
+ /// property of the capability rather than of the kind, and is
+ /// published as `voice_only` / `runs_only` on
+ /// `GET /v1/agents/tool-capabilities`. + /// #if NET7_0_OR_GREATER [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers] #endif @@ -200,7 +217,8 @@ public AgentTool( string? webhookSecret, global::Speechify.ToolActionClass? actionClass, global::Speechify.ToolApprovalClass? approval, - global::Speechify.ToolApprovalClass? effectiveApproval) + global::Speechify.ToolApprovalClass? effectiveApproval, + global::System.Collections.Generic.IList? reach) { this.Id = id ?? throw new global::System.ArgumentNullException(nameof(id)); this.Kind = kind; @@ -214,6 +232,7 @@ public AgentTool( this.EffectiveActionClass = effectiveActionClass; this.Approval = approval; this.EffectiveApproval = effectiveApproval; + this.Reach = reach; this.CreatedAt = createdAt; this.UpdatedAt = updatedAt; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.Contact.g.cs b/src/libs/Speechify/Generated/Speechify.Models.Contact.g.cs index 777afe2f..45f0142b 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.Contact.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.Contact.g.cs @@ -67,7 +67,13 @@ public sealed partial class Contact public required global::System.DateTime FirstSeenAt { get; set; } /// - /// + /// The most recent sighting recorded for this person, across every
+ /// channel and agent: the time of the last turn they spoke, or of the
+ /// last conversation opened for them if they have not spoken since.
+ /// A person mid-exchange on a long-running thread therefore reads as
+ /// seen at their latest message rather than when the thread opened.
+ /// Drives the default list ordering, and a merge widens it to span
+ /// both records. /// [global::System.Text.Json.Serialization.JsonPropertyName("last_seen_at")] [global::System.Text.Json.Serialization.JsonRequired] @@ -121,7 +127,15 @@ public sealed partial class Contact /// this to span both records, because the window belongs to the
/// person rather than to whichever record saw them first. /// - /// + /// + /// The most recent sighting recorded for this person, across every
+ /// channel and agent: the time of the last turn they spoke, or of the
+ /// last conversation opened for them if they have not spoken since.
+ /// A person mid-exchange on a long-running thread therefore reads as
+ /// seen at their latest message rather than when the thread opened.
+ /// Drives the default list ordering, and a merge widens it to span
+ /// both records. + /// /// /// /// diff --git a/src/libs/Speechify/Generated/Speechify.Models.Conversation.g.cs b/src/libs/Speechify/Generated/Speechify.Models.Conversation.g.cs index 604ce7c5..781a1d96 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.Conversation.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.Conversation.g.cs @@ -123,14 +123,17 @@ public sealed partial class Conversation /// /// Coarse termination category. Most reasons are assigned by the
/// agent runtime as the call ends; `caller_hangup` may also be
- /// applied server-side as a post-call catch-all. The `dial_*`
- /// reasons are assigned server-side on a `failed` conversation
- /// for an outbound call that never connected.
+ /// applied server-side as a post-call catch-all, and
+ /// `operator_ended` is assigned server-side when the force-end
+ /// endpoint is called. The `dial_*` reasons are assigned
+ /// server-side on a `failed` conversation for an outbound call
+ /// that never connected.
/// * `voicemail_message_left` — AMD machine-vm + we spoke the configured drop-message.
/// * `voicemail_hangup` — AMD machine-vm + we terminated silently (action=hangup or empty-message bypass).
/// * `ivr_hangup` — AMD machine-ivr + action=hangup.
/// * `unavailable_hangup` — AMD machine-unavailable (mailbox full / disconnected).
/// * `agent_ended` — LLM-driven end_call builtin.
+ /// * `operator_ended` - the conversation was closed deliberately through the force-end endpoint, by a person in the console or by your own backend. Distinguishes a human intervention from the agent deciding it was done or the caller going away.
/// * `inactivity_timeout` — the call ended after the configured silence window elapsed with no activity.
/// * `loop_detected` — a loop guard force-ended the call after several consecutive near-identical user turns (typically an IVR replaying its menu while the agent kept reacting instead of ending the call).
/// * `max_duration_reached` - the max-call-duration limit force-ended the call at the platform ceiling (a safety bound on runaway calls).
@@ -348,14 +351,17 @@ public sealed partial class Conversation /// /// Coarse termination category. Most reasons are assigned by the
/// agent runtime as the call ends; `caller_hangup` may also be
- /// applied server-side as a post-call catch-all. The `dial_*`
- /// reasons are assigned server-side on a `failed` conversation
- /// for an outbound call that never connected.
+ /// applied server-side as a post-call catch-all, and
+ /// `operator_ended` is assigned server-side when the force-end
+ /// endpoint is called. The `dial_*` reasons are assigned
+ /// server-side on a `failed` conversation for an outbound call
+ /// that never connected.
/// * `voicemail_message_left` — AMD machine-vm + we spoke the configured drop-message.
/// * `voicemail_hangup` — AMD machine-vm + we terminated silently (action=hangup or empty-message bypass).
/// * `ivr_hangup` — AMD machine-ivr + action=hangup.
/// * `unavailable_hangup` — AMD machine-unavailable (mailbox full / disconnected).
/// * `agent_ended` — LLM-driven end_call builtin.
+ /// * `operator_ended` - the conversation was closed deliberately through the force-end endpoint, by a person in the console or by your own backend. Distinguishes a human intervention from the agent deciding it was done or the caller going away.
/// * `inactivity_timeout` — the call ended after the configured silence window elapsed with no activity.
/// * `loop_detected` — a loop guard force-ended the call after several consecutive near-identical user turns (typically an IVR replaying its menu while the agent kept reacting instead of ending the call).
/// * `max_duration_reached` - the max-call-duration limit force-ended the call at the platform ceiling (a safety bound on runaway calls).
diff --git a/src/libs/Speechify/Generated/Speechify.Models.ConversationEndReason.g.cs b/src/libs/Speechify/Generated/Speechify.Models.ConversationEndReason.g.cs index ec67d9e5..593d2c5a 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.ConversationEndReason.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.ConversationEndReason.g.cs @@ -6,14 +6,17 @@ namespace Speechify /// /// Coarse termination category. Most reasons are assigned by the
/// agent runtime as the call ends; `caller_hangup` may also be
- /// applied server-side as a post-call catch-all. The `dial_*`
- /// reasons are assigned server-side on a `failed` conversation
- /// for an outbound call that never connected.
+ /// applied server-side as a post-call catch-all, and
+ /// `operator_ended` is assigned server-side when the force-end
+ /// endpoint is called. The `dial_*` reasons are assigned
+ /// server-side on a `failed` conversation for an outbound call
+ /// that never connected.
/// * `voicemail_message_left` — AMD machine-vm + we spoke the configured drop-message.
/// * `voicemail_hangup` — AMD machine-vm + we terminated silently (action=hangup or empty-message bypass).
/// * `ivr_hangup` — AMD machine-ivr + action=hangup.
/// * `unavailable_hangup` — AMD machine-unavailable (mailbox full / disconnected).
/// * `agent_ended` — LLM-driven end_call builtin.
+ /// * `operator_ended` - the conversation was closed deliberately through the force-end endpoint, by a person in the console or by your own backend. Distinguishes a human intervention from the agent deciding it was done or the caller going away.
/// * `inactivity_timeout` — the call ended after the configured silence window elapsed with no activity.
/// * `loop_detected` — a loop guard force-ended the call after several consecutive near-identical user turns (typically an IVR replaying its menu while the agent kept reacting instead of ending the call).
/// * `max_duration_reached` - the max-call-duration limit force-ended the call at the platform ceiling (a safety bound on runaway calls).
@@ -76,6 +79,10 @@ public enum ConversationEndReason /// /// /// + OperatorEnded, + /// + /// + /// OverCapacity, /// /// @@ -118,6 +125,7 @@ public static string ToValueString(this ConversationEndReason value) ConversationEndReason.IvrHangup => "ivr_hangup", ConversationEndReason.LoopDetected => "loop_detected", ConversationEndReason.MaxDurationReached => "max_duration_reached", + ConversationEndReason.OperatorEnded => "operator_ended", ConversationEndReason.OverCapacity => "over_capacity", ConversationEndReason.Transferred => "transferred", ConversationEndReason.UnavailableHangup => "unavailable_hangup", @@ -144,6 +152,7 @@ public static string ToValueString(this ConversationEndReason value) "ivr_hangup" => ConversationEndReason.IvrHangup, "loop_detected" => ConversationEndReason.LoopDetected, "max_duration_reached" => ConversationEndReason.MaxDurationReached, + "operator_ended" => ConversationEndReason.OperatorEnded, "over_capacity" => ConversationEndReason.OverCapacity, "transferred" => ConversationEndReason.Transferred, "unavailable_hangup" => ConversationEndReason.UnavailableHangup, diff --git a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRequest.g.cs b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRequest.g.cs index cac7cd29..583df849 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRequest.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRequest.g.cs @@ -29,7 +29,7 @@ public sealed partial class CreateHostedAPIRequest public string? Description { get; set; } /// - /// consumer_key when omitted. + /// consumer_key when omitted. `public` is refused with 403 `hosted_api_public_refused` where the workspace's policy does not allow internet-facing APIs. /// [global::System.Text.Json.Serialization.JsonPropertyName("auth_mode")] [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Speechify.JsonConverters.CreateHostedApiRequestAuthModeJsonConverter))] @@ -53,6 +53,12 @@ public sealed partial class CreateHostedAPIRequest [global::System.Text.Json.Serialization.JsonPropertyName("daily_read_cap")] public int? DailyReadCap { get; set; } + /// + /// Documents the API's write routes may land per UTC day; 10000 when omitted. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("daily_write_cap")] + public int? DailyWriteCap { get; set; } + /// /// /// @@ -80,7 +86,7 @@ public sealed partial class CreateHostedAPIRequest /// /// /// - /// consumer_key when omitted. + /// consumer_key when omitted. `public` is refused with 403 `hosted_api_public_refused` where the workspace's policy does not allow internet-facing APIs. /// /// /// @@ -89,6 +95,9 @@ public sealed partial class CreateHostedAPIRequest /// /// Reads the API may serve from storage per UTC day; 100000 when omitted. /// + /// + /// Documents the API's write routes may land per UTC day; 10000 when omitted. + /// /// /// /// Register the key set end-user tokens are verified against (an `https` URL on a public host). @@ -104,6 +113,7 @@ public CreateHostedAPIRequest( global::System.Collections.Generic.IList? corsOrigins, int? dailyRunCap, int? dailyReadCap, + int? dailyWriteCap, string? projectId, string? userTokenJwksUrl) { @@ -114,6 +124,7 @@ public CreateHostedAPIRequest( this.CorsOrigins = corsOrigins; this.DailyRunCap = dailyRunCap; this.DailyReadCap = dailyReadCap; + this.DailyWriteCap = dailyWriteCap; this.ProjectId = projectId; this.UserTokenJwksUrl = userTokenJwksUrl; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRouteRequest.g.cs b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRouteRequest.g.cs index ff54798e..bc3541c3 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRouteRequest.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedAPIRouteRequest.g.cs @@ -42,6 +42,11 @@ public sealed partial class CreateHostedAPIRouteRequest /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
@@ -89,6 +94,11 @@ public sealed partial class CreateHostedAPIRouteRequest /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedApiRequestAuthMode.g.cs b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedApiRequestAuthMode.g.cs index 73c72944..3bd51809 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.CreateHostedApiRequestAuthMode.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.CreateHostedApiRequestAuthMode.g.cs @@ -4,7 +4,7 @@ namespace Speechify { /// - /// consumer_key when omitted. + /// consumer_key when omitted. `public` is refused with 403 `hosted_api_public_refused` where the workspace's policy does not allow internet-facing APIs. /// public enum CreateHostedApiRequestAuthMode { @@ -15,11 +15,19 @@ public enum CreateHostedApiRequestAuthMode /// /// /// + Owner, + /// + /// + /// Public, /// /// /// UserToken, + /// + /// + /// + Workspace, } /// @@ -35,8 +43,10 @@ public static string ToValueString(this CreateHostedApiRequestAuthMode value) return value switch { CreateHostedApiRequestAuthMode.ConsumerKey => "consumer_key", + CreateHostedApiRequestAuthMode.Owner => "owner", CreateHostedApiRequestAuthMode.Public => "public", CreateHostedApiRequestAuthMode.UserToken => "user_token", + CreateHostedApiRequestAuthMode.Workspace => "workspace", _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), }; } @@ -48,8 +58,10 @@ public static string ToValueString(this CreateHostedApiRequestAuthMode value) return value switch { "consumer_key" => CreateHostedApiRequestAuthMode.ConsumerKey, + "owner" => CreateHostedApiRequestAuthMode.Owner, "public" => CreateHostedApiRequestAuthMode.Public, "user_token" => CreateHostedApiRequestAuthMode.UserToken, + "workspace" => CreateHostedApiRequestAuthMode.Workspace, _ => null, }; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.ErrorCode.g.cs b/src/libs/Speechify/Generated/Speechify.Models.ErrorCode.g.cs index c98d14e7..0d3ca08a 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.ErrorCode.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.ErrorCode.g.cs @@ -244,6 +244,10 @@ public enum ErrorCode /// /// /// + HostedApiPublicRefused, + /// + /// + /// HostedApiSlugTaken, /// /// @@ -412,6 +416,10 @@ public enum ErrorCode /// /// /// + RouteWriteLimitReached, + /// + /// + /// ServiceAccountLimitReached, /// /// @@ -680,6 +688,7 @@ public static string ToValueString(this ErrorCode value) ErrorCode.Forbidden => "forbidden", ErrorCode.FundedBalanceRequired => "funded_balance_required", ErrorCode.HostedApiNotFound => "hosted_api_not_found", + ErrorCode.HostedApiPublicRefused => "hosted_api_public_refused", ErrorCode.HostedApiSlugTaken => "hosted_api_slug_taken", ErrorCode.HostedApisNotInPlan => "hosted_apis_not_in_plan", ErrorCode.IdempotencyConflict => "idempotency_conflict", @@ -722,6 +731,7 @@ public static string ToValueString(this ErrorCode value) ErrorCode.RouteRunFailed => "route_run_failed", ErrorCode.RouteRunLimitReached => "route_run_limit_reached", ErrorCode.RouteRunTimeout => "route_run_timeout", + ErrorCode.RouteWriteLimitReached => "route_write_limit_reached", ErrorCode.ServiceAccountLimitReached => "service_account_limit_reached", ErrorCode.ServiceAccountsNotInPlan => "service_accounts_not_in_plan", ErrorCode.ServiceUnavailable => "service_unavailable", @@ -839,6 +849,7 @@ public static string ToValueString(this ErrorCode value) "forbidden" => ErrorCode.Forbidden, "funded_balance_required" => ErrorCode.FundedBalanceRequired, "hosted_api_not_found" => ErrorCode.HostedApiNotFound, + "hosted_api_public_refused" => ErrorCode.HostedApiPublicRefused, "hosted_api_slug_taken" => ErrorCode.HostedApiSlugTaken, "hosted_apis_not_in_plan" => ErrorCode.HostedApisNotInPlan, "idempotency_conflict" => ErrorCode.IdempotencyConflict, @@ -881,6 +892,7 @@ public static string ToValueString(this ErrorCode value) "route_run_failed" => ErrorCode.RouteRunFailed, "route_run_limit_reached" => ErrorCode.RouteRunLimitReached, "route_run_timeout" => ErrorCode.RouteRunTimeout, + "route_write_limit_reached" => ErrorCode.RouteWriteLimitReached, "service_account_limit_reached" => ErrorCode.ServiceAccountLimitReached, "service_accounts_not_in_plan" => ErrorCode.ServiceAccountsNotInPlan, "service_unavailable" => ErrorCode.ServiceUnavailable, diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedAPI.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedAPI.g.cs index 115b5e15..6dd1ed86 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedAPI.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedAPI.g.cs @@ -53,14 +53,20 @@ public sealed partial class HostedAPI public required string Description { get; set; } /// - /// `consumer_key`: every request presents a `ck_` bearer minted for this
- /// API. `public`: no credential; only read resolvers may be served, and
- /// the per-IP limiter is the only bound. `user_token`: every request
- /// presents a short-lived JWT your backend signed for the calling user
- /// (`sub`, `exp` within 24 hours, optional `aud` naming this API),
- /// verified against the API's signing secret (HS256) or its registered
- /// JWKS URL (RS256 / ES256 / EdDSA). Routes bind the verified claims as
- /// `{{user.sub}}` and the response cache is keyed per user. + /// Who the API answers, narrowest first. `owner`: only the API's owner,
+ /// with their own Speechify API key or console session. `workspace`:
+ /// any member of the owning workspace, the same way. `user_token`:
+ /// every request presents a short-lived JWT your backend signed for the
+ /// calling user (`sub`, `exp` within 24 hours, optional `aud` naming
+ /// this API), verified against the API's signing secret (HS256) or its
+ /// registered JWKS URL (RS256 / ES256 / EdDSA). `consumer_key`: every
+ /// request presents a `ck_` bearer minted for this API. `public`: no
+ /// credential; only read resolvers may be served, the per-IP limiter is
+ /// the only bound, and a workspace can refuse it as policy
+ /// (`hosted_apis_public_allowed`). The three modes that name a person
+ /// (`owner`, `workspace`, `user_token`) let routes bind `{{user.sub}}`,
+ /// key the response cache per person, and stamp a written document as
+ /// that person's. /// [global::System.Text.Json.Serialization.JsonPropertyName("auth_mode")] [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Speechify.JsonConverters.HostedApiAuthModeJsonConverter))] @@ -101,6 +107,15 @@ public sealed partial class HostedAPI [global::System.Text.Json.Serialization.JsonPropertyName("daily_read_cap")] public int? DailyReadCap { get; set; } + /// + /// Documents the API's write routes may land per UTC day; the storage
+ /// ceiling behind a leaked key on a write route. Past the cap a write
+ /// route answers 429 `route_write_limit_reached`. Optional on the wire
+ /// for the same reason as `daily_read_cap`. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("daily_write_cap")] + public int? DailyWriteCap { get; set; } + /// /// /// @@ -154,14 +169,20 @@ public sealed partial class HostedAPI /// /// /// - /// `consumer_key`: every request presents a `ck_` bearer minted for this
- /// API. `public`: no credential; only read resolvers may be served, and
- /// the per-IP limiter is the only bound. `user_token`: every request
- /// presents a short-lived JWT your backend signed for the calling user
- /// (`sub`, `exp` within 24 hours, optional `aud` naming this API),
- /// verified against the API's signing secret (HS256) or its registered
- /// JWKS URL (RS256 / ES256 / EdDSA). Routes bind the verified claims as
- /// `{{user.sub}}` and the response cache is keyed per user. + /// Who the API answers, narrowest first. `owner`: only the API's owner,
+ /// with their own Speechify API key or console session. `workspace`:
+ /// any member of the owning workspace, the same way. `user_token`:
+ /// every request presents a short-lived JWT your backend signed for the
+ /// calling user (`sub`, `exp` within 24 hours, optional `aud` naming
+ /// this API), verified against the API's signing secret (HS256) or its
+ /// registered JWKS URL (RS256 / ES256 / EdDSA). `consumer_key`: every
+ /// request presents a `ck_` bearer minted for this API. `public`: no
+ /// credential; only read resolvers may be served, the per-IP limiter is
+ /// the only bound, and a workspace can refuse it as policy
+ /// (`hosted_apis_public_allowed`). The three modes that name a person
+ /// (`owner`, `workspace`, `user_token`) let routes bind `{{user.sub}}`,
+ /// key the response cache per person, and stamp a written document as
+ /// that person's. /// /// /// Browser origins allowed to call the API (`*` for any). Empty for server-to-server only. @@ -182,6 +203,12 @@ public sealed partial class HostedAPI /// counts: a public route is paused by the limiter in that state, a
/// keyed or tokened caller passes. /// + /// + /// Documents the API's write routes may land per UTC day; the storage
+ /// ceiling behind a leaked key on a write route. Past the cap a write
+ /// route answers 429 `route_write_limit_reached`. Optional on the wire
+ /// for the same reason as `daily_read_cap`. + /// /// /// /// The key set end-user tokens are verified against when set (an
@@ -209,6 +236,7 @@ public HostedAPI( global::System.DateTime createdAt, global::System.DateTime updatedAt, int? dailyReadCap, + int? dailyWriteCap, string? projectId, string? userTokenJwksUrl, string? userTokenSecretHint) @@ -224,6 +252,7 @@ public HostedAPI( this.Enabled = enabled; this.DailyRunCap = dailyRunCap; this.DailyReadCap = dailyReadCap; + this.DailyWriteCap = dailyWriteCap; this.ProjectId = projectId; this.UserTokenJwksUrl = userTokenJwksUrl; this.UserTokenSecretHint = userTokenSecretHint; diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIResolver.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIResolver.g.cs index dc4a14f2..540e2be7 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIResolver.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIResolver.g.cs @@ -10,6 +10,11 @@ namespace Speechify /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
@@ -38,11 +43,23 @@ public sealed partial class HostedAPIResolver public string? Collection { get; set; } /// - /// A literal id, a `{{path.x}}` / `{{query.x}}` template bound from the request, or a `{{user.x}}` claim of the verified end-user token. + /// A literal id, a `{{path.x}}` / `{{query.x}}` / `{{body.x}}` template bound from the request, or a `{{user.x}}` claim of the verified caller. On a `store_write` route it names the document a replace or merge lands on, and is refused on a create. /// [global::System.Text.Json.Serialization.JsonPropertyName("document_id")] public string? DocumentId { get; set; } + /// + /// For a `store_write` route: `create` mints an id and answers 201
+ /// with the document; `replace` and `merge` land on `document_id`
+ /// (a merge sets the fields sent and keeps the rest) and answer 200.
+ /// Omitted, a route with a document_id merges and one without
+ /// creates. On an API that names its caller, a replace or merge of
+ /// another person's document is not found. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("write_mode")] + [global::System.Text.Json.Serialization.JsonConverter(typeof(global::Speechify.JsonConverters.HostedApiResolverWriteModeJsonConverter))] + public global::Speechify.HostedApiResolverWriteMode? WriteMode { get; set; } + /// /// /// @@ -142,7 +159,15 @@ public sealed partial class HostedAPIResolver /// /// /// - /// A literal id, a `{{path.x}}` / `{{query.x}}` template bound from the request, or a `{{user.x}}` claim of the verified end-user token. + /// A literal id, a `{{path.x}}` / `{{query.x}}` / `{{body.x}}` template bound from the request, or a `{{user.x}}` claim of the verified caller. On a `store_write` route it names the document a replace or merge lands on, and is refused on a create. + /// + /// + /// For a `store_write` route: `create` mints an id and answers 201
+ /// with the document; `replace` and `merge` land on `document_id`
+ /// (a merge sets the fields sent and keeps the rest) and answer 200.
+ /// Omitted, a route with a document_id merges and one without
+ /// creates. On an API that names its caller, a replace or merge of
+ /// another person's document is not found. /// /// /// @@ -202,6 +227,7 @@ public HostedAPIResolver( string? storeId, string? collection, string? documentId, + global::Speechify.HostedApiResolverWriteMode? writeMode, global::System.Collections.Generic.IList? where, global::Speechify.HostedApiResolverOrderBy? orderBy, int? limit, @@ -217,6 +243,7 @@ public HostedAPIResolver( this.StoreId = storeId; this.Collection = collection; this.DocumentId = documentId; + this.WriteMode = writeMode; this.Where = where; this.OrderBy = orderBy; this.Limit = limit; diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIRoute.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIRoute.g.cs index 59f21984..988288b1 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIRoute.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIRoute.g.cs @@ -58,6 +58,11 @@ public sealed partial class HostedAPIRoute /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
@@ -130,6 +135,11 @@ public sealed partial class HostedAPIRoute /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIUsage.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIUsage.g.cs index 5738b4c7..d05f2a19 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedAPIUsage.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedAPIUsage.g.cs @@ -43,6 +43,20 @@ public sealed partial class HostedAPIUsage [global::System.Text.Json.Serialization.JsonRequired] public required int DailyRunCap { get; set; } + /// + /// Documents landed today through the API's write routes. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("writes")] + [global::System.Text.Json.Serialization.JsonRequired] + public required long Writes { get; set; } + + /// + /// + /// + [global::System.Text.Json.Serialization.JsonPropertyName("daily_write_cap")] + [global::System.Text.Json.Serialization.JsonRequired] + public required int DailyWriteCap { get; set; } + /// /// /// @@ -77,6 +91,10 @@ public sealed partial class HostedAPIUsage /// Runs started today through the API's run routes. /// /// + /// + /// Documents landed today through the API's write routes. + /// + /// /// /// /// False where nothing counts (no Redis); the numbers are then zero, not quiet. @@ -90,6 +108,8 @@ public HostedAPIUsage( int dailyReadCap, long runs, int dailyRunCap, + long writes, + int dailyWriteCap, global::System.Collections.Generic.IList routes, bool countersAvailable) { @@ -98,6 +118,8 @@ public HostedAPIUsage( this.DailyReadCap = dailyReadCap; this.Runs = runs; this.DailyRunCap = dailyRunCap; + this.Writes = writes; + this.DailyWriteCap = dailyWriteCap; this.Routes = routes ?? throw new global::System.ArgumentNullException(nameof(routes)); this.CountersAvailable = countersAvailable; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedApiAuthMode.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedApiAuthMode.g.cs index b0300281..699a7838 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedApiAuthMode.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedApiAuthMode.g.cs @@ -4,29 +4,43 @@ namespace Speechify { /// - /// `consumer_key`: every request presents a `ck_` bearer minted for this
- /// API. `public`: no credential; only read resolvers may be served, and
- /// the per-IP limiter is the only bound. `user_token`: every request
- /// presents a short-lived JWT your backend signed for the calling user
- /// (`sub`, `exp` within 24 hours, optional `aud` naming this API),
- /// verified against the API's signing secret (HS256) or its registered
- /// JWKS URL (RS256 / ES256 / EdDSA). Routes bind the verified claims as
- /// `{{user.sub}}` and the response cache is keyed per user. + /// Who the API answers, narrowest first. `owner`: only the API's owner,
+ /// with their own Speechify API key or console session. `workspace`:
+ /// any member of the owning workspace, the same way. `user_token`:
+ /// every request presents a short-lived JWT your backend signed for the
+ /// calling user (`sub`, `exp` within 24 hours, optional `aud` naming
+ /// this API), verified against the API's signing secret (HS256) or its
+ /// registered JWKS URL (RS256 / ES256 / EdDSA). `consumer_key`: every
+ /// request presents a `ck_` bearer minted for this API. `public`: no
+ /// credential; only read resolvers may be served, the per-IP limiter is
+ /// the only bound, and a workspace can refuse it as policy
+ /// (`hosted_apis_public_allowed`). The three modes that name a person
+ /// (`owner`, `workspace`, `user_token`) let routes bind `{{user.sub}}`,
+ /// key the response cache per person, and stamp a written document as
+ /// that person's. /// public enum HostedApiAuthMode { /// - /// every request presents a `ck_` bearer minted for this + /// every /// ConsumerKey, /// - /// no credential; only read resolvers may be served, and + /// only the API's owner, + /// + Owner, + /// + /// no /// Public, /// - /// every request + /// /// UserToken, + /// + /// + /// + Workspace, } /// @@ -42,8 +56,10 @@ public static string ToValueString(this HostedApiAuthMode value) return value switch { HostedApiAuthMode.ConsumerKey => "consumer_key", + HostedApiAuthMode.Owner => "owner", HostedApiAuthMode.Public => "public", HostedApiAuthMode.UserToken => "user_token", + HostedApiAuthMode.Workspace => "workspace", _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), }; } @@ -55,8 +71,10 @@ public static string ToValueString(this HostedApiAuthMode value) return value switch { "consumer_key" => HostedApiAuthMode.ConsumerKey, + "owner" => HostedApiAuthMode.Owner, "public" => HostedApiAuthMode.Public, "user_token" => HostedApiAuthMode.UserToken, + "workspace" => HostedApiAuthMode.Workspace, _ => null, }; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverType.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverType.g.cs index 17ca4c80..628b5616 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverType.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverType.g.cs @@ -32,6 +32,10 @@ public enum HostedApiResolverType /// /// StoreQuery, + /// + /// + /// + StoreWrite, } /// @@ -52,6 +56,7 @@ public static string ToValueString(this HostedApiResolverType value) HostedApiResolverType.StoreAggregate => "store_aggregate", HostedApiResolverType.StoreDocument => "store_document", HostedApiResolverType.StoreQuery => "store_query", + HostedApiResolverType.StoreWrite => "store_write", _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), }; } @@ -68,6 +73,7 @@ public static string ToValueString(this HostedApiResolverType value) "store_aggregate" => HostedApiResolverType.StoreAggregate, "store_document" => HostedApiResolverType.StoreDocument, "store_query" => HostedApiResolverType.StoreQuery, + "store_write" => HostedApiResolverType.StoreWrite, _ => null, }; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverWriteMode.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverWriteMode.g.cs new file mode 100644 index 00000000..fd1bb8eb --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedApiResolverWriteMode.g.cs @@ -0,0 +1,62 @@ + +#nullable enable + +namespace Speechify +{ + /// + /// For a `store_write` route: `create` mints an id and answers 201
+ /// with the document; `replace` and `merge` land on `document_id`
+ /// (a merge sets the fields sent and keeps the rest) and answer 200.
+ /// Omitted, a route with a document_id merges and one without
+ /// creates. On an API that names its caller, a replace or merge of
+ /// another person's document is not found. + /// + public enum HostedApiResolverWriteMode + { + /// + /// `create` mints an id and answers 201 + /// + Create, + /// + /// + /// + Merge, + /// + /// + /// + Replace, + } + + /// + /// Enum extensions to do fast conversions without the reflection. + /// + public static class HostedApiResolverWriteModeExtensions + { + /// + /// Converts an enum to a string. + /// + public static string ToValueString(this HostedApiResolverWriteMode value) + { + return value switch + { + HostedApiResolverWriteMode.Create => "create", + HostedApiResolverWriteMode.Merge => "merge", + HostedApiResolverWriteMode.Replace => "replace", + _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), + }; + } + /// + /// Converts an string to a enum. + /// + public static HostedApiResolverWriteMode? ToEnum(string value) + { + return value switch + { + "create" => HostedApiResolverWriteMode.Create, + "merge" => HostedApiResolverWriteMode.Merge, + "replace" => HostedApiResolverWriteMode.Replace, + _ => null, + }; + } + } +} \ No newline at end of file diff --git a/src/libs/Speechify/Generated/Speechify.Models.HostedApiUsageRoutesItems.g.cs b/src/libs/Speechify/Generated/Speechify.Models.HostedApiUsageRoutesItems.g.cs index b86239ee..e1e1ef69 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.HostedApiUsageRoutesItems.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.HostedApiUsageRoutesItems.g.cs @@ -22,6 +22,13 @@ public sealed partial class HostedApiUsageRoutesItems [global::System.Text.Json.Serialization.JsonRequired] public required long Reads { get; set; } + /// + /// + /// + [global::System.Text.Json.Serialization.JsonPropertyName("writes")] + [global::System.Text.Json.Serialization.JsonRequired] + public required long Writes { get; set; } + /// /// Additional properties that are not explicitly defined in the schema /// @@ -33,15 +40,18 @@ public sealed partial class HostedApiUsageRoutesItems /// /// /// + /// #if NET7_0_OR_GREATER [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers] #endif public HostedApiUsageRoutesItems( string routeId, - long reads) + long reads, + long writes) { this.RouteId = routeId ?? throw new global::System.ArgumentNullException(nameof(routeId)); this.Reads = reads; + this.Writes = writes; } /// diff --git a/src/libs/Speechify/Generated/Speechify.Models.Tool.g.cs b/src/libs/Speechify/Generated/Speechify.Models.Tool.g.cs index f05088ad..105e6343 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.Tool.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.Tool.g.cs @@ -123,6 +123,21 @@ public sealed partial class Tool [global::System.Text.Json.Serialization.JsonRequired] public required global::Speechify.ToolApprovalClass EffectiveApproval { get; set; } + /// + /// Where a call to this tool can execute, derived from its `kind`.
+ /// Read-only.
+ /// A `webhook` or `mcp` tool reaches every surface. A `client` tool
+ /// reaches `voice` only: its call is answered by your own application
+ /// over the live session's data channel, so it needs a realtime
+ /// session your client is connected to. Neither the roomless text
+ /// runtime nor an autonomous run has one, and both drop the tool
+ /// before the model is offered it - so attaching a `client` tool to
+ /// an agent with no `voice` channel attaches a capability that can
+ /// never fire. + /// + [global::System.Text.Json.Serialization.JsonPropertyName("reach")] + public global::System.Collections.Generic.IList? Reach { get; set; } + /// /// /// @@ -194,6 +209,18 @@ public sealed partial class Tool /// Your explicit override of the approval derived from the class.
/// Null means derived. /// + /// + /// Where a call to this tool can execute, derived from its `kind`.
+ /// Read-only.
+ /// A `webhook` or `mcp` tool reaches every surface. A `client` tool
+ /// reaches `voice` only: its call is answered by your own application
+ /// over the live session's data channel, so it needs a realtime
+ /// session your client is connected to. Neither the roomless text
+ /// runtime nor an autonomous run has one, and both drop the tool
+ /// before the model is offered it - so attaching a `client` tool to
+ /// an agent with no `voice` channel attaches a capability that can
+ /// never fire. + /// #if NET7_0_OR_GREATER [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers] #endif @@ -210,7 +237,8 @@ public Tool( string? webhookSecret, string? projectId, global::Speechify.ToolActionClass? actionClass, - global::Speechify.ToolApprovalClass? approval) + global::Speechify.ToolApprovalClass? approval, + global::System.Collections.Generic.IList? reach) { this.Id = id ?? throw new global::System.ArgumentNullException(nameof(id)); this.Name = name ?? throw new global::System.ArgumentNullException(nameof(name)); @@ -223,6 +251,7 @@ public Tool( this.EffectiveActionClass = effectiveActionClass; this.Approval = approval; this.EffectiveApproval = effectiveApproval; + this.Reach = reach; this.CreatedAt = createdAt; this.UpdatedAt = updatedAt; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.ToolReach.g.cs b/src/libs/Speechify/Generated/Speechify.Models.ToolReach.g.cs new file mode 100644 index 00000000..03bc95c0 --- /dev/null +++ b/src/libs/Speechify/Generated/Speechify.Models.ToolReach.g.cs @@ -0,0 +1,66 @@ + +#nullable enable + +namespace Speechify +{ + /// + /// A surface that can execute a call to a tool. The values are the
+ /// surfaces an agent is reached on - the same vocabulary as its
+ /// `channels` - plus the autonomous run every agent can be started as,
+ /// so a tool's `reach` intersected with an agent's own doors answers
+ /// "will this ever fire on that agent".
+ /// - `voice`: a live realtime session (a room, reached over telephony or
+ /// the browser/SDK).
+ /// - `text`: the roomless turn runtime the message API and every
+ /// messaging channel, Slack included, share.
+ /// - `run`: an autonomous durable run. + /// + public enum ToolReach + { + /// + /// the roomless turn runtime the message API and every + /// + Run, + /// + /// the roomless turn runtime the message API and every + /// + Text, + /// + /// a live realtime session (a room, reached over telephony or + /// + Voice, + } + + /// + /// Enum extensions to do fast conversions without the reflection. + /// + public static class ToolReachExtensions + { + /// + /// Converts an enum to a string. + /// + public static string ToValueString(this ToolReach value) + { + return value switch + { + ToolReach.Run => "run", + ToolReach.Text => "text", + ToolReach.Voice => "voice", + _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), + }; + } + /// + /// Converts an string to a enum. + /// + public static ToolReach? ToEnum(string value) + { + return value switch + { + "run" => ToolReach.Run, + "text" => ToolReach.Text, + "voice" => ToolReach.Voice, + _ => null, + }; + } + } +} \ No newline at end of file diff --git a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRequest.g.cs b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRequest.g.cs index 255ade33..db4f75ff 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRequest.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRequest.g.cs @@ -51,6 +51,12 @@ public sealed partial class UpdateHostedAPIRequest [global::System.Text.Json.Serialization.JsonPropertyName("daily_read_cap")] public int? DailyReadCap { get; set; } + /// + /// + /// + [global::System.Text.Json.Serialization.JsonPropertyName("daily_write_cap")] + public int? DailyWriteCap { get; set; } + /// /// Replace the registered key set; an empty string removes it, after which the signing secret verifies tokens again. /// @@ -75,6 +81,7 @@ public sealed partial class UpdateHostedAPIRequest /// /// /// + /// /// /// Replace the registered key set; an empty string removes it, after which the signing secret verifies tokens again. /// @@ -89,6 +96,7 @@ public UpdateHostedAPIRequest( bool? enabled, int? dailyRunCap, int? dailyReadCap, + int? dailyWriteCap, string? userTokenJwksUrl) { this.Name = name; @@ -98,6 +106,7 @@ public UpdateHostedAPIRequest( this.Enabled = enabled; this.DailyRunCap = dailyRunCap; this.DailyReadCap = dailyReadCap; + this.DailyWriteCap = dailyWriteCap; this.UserTokenJwksUrl = userTokenJwksUrl; } diff --git a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRouteRequest.g.cs b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRouteRequest.g.cs index 90f7dadc..61c3d901 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRouteRequest.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedAPIRouteRequest.g.cs @@ -40,6 +40,11 @@ public sealed partial class UpdateHostedAPIRouteRequest /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
@@ -86,6 +91,11 @@ public sealed partial class UpdateHostedAPIRouteRequest /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedApiRequestAuthMode.g.cs b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedApiRequestAuthMode.g.cs index 5972ea62..fde7865d 100644 --- a/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedApiRequestAuthMode.g.cs +++ b/src/libs/Speechify/Generated/Speechify.Models.UpdateHostedApiRequestAuthMode.g.cs @@ -15,11 +15,19 @@ public enum UpdateHostedApiRequestAuthMode /// /// /// + Owner, + /// + /// + /// Public, /// /// /// UserToken, + /// + /// + /// + Workspace, } /// @@ -35,8 +43,10 @@ public static string ToValueString(this UpdateHostedApiRequestAuthMode value) return value switch { UpdateHostedApiRequestAuthMode.ConsumerKey => "consumer_key", + UpdateHostedApiRequestAuthMode.Owner => "owner", UpdateHostedApiRequestAuthMode.Public => "public", UpdateHostedApiRequestAuthMode.UserToken => "user_token", + UpdateHostedApiRequestAuthMode.Workspace => "workspace", _ => throw new global::System.ArgumentOutOfRangeException(nameof(value), value, null), }; } @@ -48,8 +58,10 @@ public static string ToValueString(this UpdateHostedApiRequestAuthMode value) return value switch { "consumer_key" => UpdateHostedApiRequestAuthMode.ConsumerKey, + "owner" => UpdateHostedApiRequestAuthMode.Owner, "public" => UpdateHostedApiRequestAuthMode.Public, "user_token" => UpdateHostedApiRequestAuthMode.UserToken, + "workspace" => UpdateHostedApiRequestAuthMode.Workspace, _ => null, }; } diff --git a/src/libs/Speechify/Generated/Speechify.RoutesClient.CreateRoute.g.cs b/src/libs/Speechify/Generated/Speechify.RoutesClient.CreateRoute.g.cs index 927d25fa..392882ec 100644 --- a/src/libs/Speechify/Generated/Speechify.RoutesClient.CreateRoute.g.cs +++ b/src/libs/Speechify/Generated/Speechify.RoutesClient.CreateRoute.g.cs @@ -49,21 +49,26 @@ partial void ProcessCreateRouteResponseContent( /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -98,21 +103,26 @@ partial void ProcessCreateRouteResponseContent( } /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -691,21 +701,26 @@ partial void ProcessCreateRouteResponseContent( } /// /// Create Route
- /// Add a route: a method + path answered by a resolver. `store_query` and
- /// `store_document` serve a store; `run_latest` serves the newest
- /// structured output of a schedule trigger's runs; `run` starts a run
- /// through a webhook trigger per request (POST only, never on a public
- /// API) and waits up to `wait_seconds` before answering 202 with a
- /// handle to poll at `/_runs/{run_id}`; `file` serves one published file,
- /// or a whole published tree when the path ends in `*` (`/app/*` with
- /// `file_root` and `file_index`). Where-clause values and the
- /// document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
- /// templates bound from the consumer's request, or `{{user.x}}` claims
- /// of the verified end-user token on a `user_token` API; a clause whose
- /// template is absent is skipped. Two bindings are refused at write
- /// time: `{{user.*}}` on an API that does not verify end-user tokens,
- /// and a clause on `user_identity` bound from a request template, which
- /// would let any caller read any user's rows.
+ /// Add a route: a method + path answered by a resolver. `store_query`,
+ /// `store_document` and `store_aggregate` serve a store; `store_write`
+ /// lands the POST body as a document (`write_mode` create / replace /
+ /// merge; POST only, never on a public API, counted against
+ /// `daily_write_cap`, deduplicated on `Idempotency-Key`); `run_latest`
+ /// serves the newest structured output of a schedule trigger's runs;
+ /// `run` starts a run through a webhook trigger per request (POST only,
+ /// never on a public API) and waits up to `wait_seconds` before answering
+ /// 202 with a handle to poll at `/_runs/{run_id}`; `file` serves one
+ /// published file, or a whole published tree when the path ends in `*`
+ /// (`/app/*` with `file_root` and `file_index`). Where-clause values and
+ /// the document id may be `{{query.x}}`, `{{path.x}}` or `{{body.x}}`
+ /// templates bound from the consumer's request, or `{{user.x}}` claims of
+ /// the verified caller on a `user_token`, `workspace` or `owner` API; a
+ /// clause whose template is absent is skipped. On those three modes a
+ /// written document is stamped `user_identity` as the caller and only
+ /// they can replace or merge it. Two bindings are refused at write time:
+ /// `{{user.*}}` on an API that names no caller, and a clause on
+ /// `user_identity` bound from a request template, which would let any
+ /// caller read any user's rows.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -726,6 +741,11 @@ partial void ProcessCreateRouteResponseContent( /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.RoutesClient.UpdateRoute.g.cs b/src/libs/Speechify/Generated/Speechify.RoutesClient.UpdateRoute.g.cs index 52b78a94..84b9826b 100644 --- a/src/libs/Speechify/Generated/Speechify.RoutesClient.UpdateRoute.g.cs +++ b/src/libs/Speechify/Generated/Speechify.RoutesClient.UpdateRoute.g.cs @@ -672,6 +672,11 @@ partial void ProcessUpdateRouteResponseContent( /// `store_aggregate` (store_id, collection, where, group_by, metrics:
/// a summary in one request, from the same implementation as the
/// collection's `aggregate` operation),
+ /// `store_write` (store_id, collection, write_mode, document_id: the
+ /// request body lands as a document, the fast path past a run for the
+ /// one thing a read resolver cannot do; POST only, never on a public
+ /// API, and on an API that names its caller the document is that
+ /// person's),
/// `run_latest` (trigger_id of a schedule trigger),
/// `run` (trigger_id of a webhook trigger, wait_seconds),
/// `file` (file_path of one published file; or, on a route whose path
diff --git a/src/libs/Speechify/Generated/Speechify.StoresClient.Create.g.cs b/src/libs/Speechify/Generated/Speechify.StoresClient.Create.g.cs index 06c56a90..73454260 100644 --- a/src/libs/Speechify/Generated/Speechify.StoresClient.Create.g.cs +++ b/src/libs/Speechify/Generated/Speechify.StoresClient.Create.g.cs @@ -49,6 +49,10 @@ partial void ProcessCreateResponseContent( /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -82,6 +86,10 @@ partial void ProcessCreateResponseContent( /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// @@ -695,6 +703,10 @@ partial void ProcessCreateResponseContent( /// Create Store
/// Create a store. Names are unique per workspace among live stores.
/// Bounded by the workspace's store limit (409 `store_limit_reached`).
+ /// Collections are implicit (the first write names one), a document is a
+ /// JSON object of at most 256 KiB whose top-level scalar fields are
+ /// indexed, and the ids `query`, `batch` and `aggregate` are reserved for
+ /// the operations of the same name.
/// Dark launch: requires the `hosted_apis_access` entitlement (402 `hosted_apis_not_in_plan` otherwise). /// /// diff --git a/src/libs/Speechify/Generated/Speechify.StoresClient.List.g.cs b/src/libs/Speechify/Generated/Speechify.StoresClient.List.g.cs index d981cd6c..4fc4312d 100644 --- a/src/libs/Speechify/Generated/Speechify.StoresClient.List.g.cs +++ b/src/libs/Speechify/Generated/Speechify.StoresClient.List.g.cs @@ -50,8 +50,12 @@ partial void ProcessListResponseContent( /// /// List Stores
/// List the stores in the caller's workspace, most recently updated
- /// first. A store is the durable collection of JSON documents a durable
- /// run writes to (through its store tools) and a hosted-API route serves.
+ /// first. A store is a workspace-owned database of JSON documents in
+ /// named collections, Firestore-shaped: filter on top-level scalar
+ /// fields, order on one, page with a cursor, and aggregate in one
+ /// request; no joins, nested-field filters, full-text search or SQL, on
+ /// purpose. A durable run writes it through its store tools, a hosted-API
+ /// route serves it, and your own backend reads and writes it here.
/// Uploaded bytes are not stores: a file is its own resource at
/// `/v1/files`.
/// Cursor-paginated; walk pages while `has_more` is true.
@@ -88,8 +92,12 @@ partial void ProcessListResponseContent( /// /// List Stores
/// List the stores in the caller's workspace, most recently updated
- /// first. A store is the durable collection of JSON documents a durable
- /// run writes to (through its store tools) and a hosted-API route serves.
+ /// first. A store is a workspace-owned database of JSON documents in
+ /// named collections, Firestore-shaped: filter on top-level scalar
+ /// fields, order on one, page with a cursor, and aggregate in one
+ /// request; no joins, nested-field filters, full-text search or SQL, on
+ /// purpose. A durable run writes it through its store tools, a hosted-API
+ /// route serves it, and your own backend reads and writes it here.
/// Uploaded bytes are not stores: a file is its own resource at
/// `/v1/files`.
/// Cursor-paginated; walk pages while `has_more` is true.
diff --git a/src/libs/Speechify/openapi.yaml b/src/libs/Speechify/openapi.yaml index 5234ec04..97432fd4 100644 --- a/src/libs/Speechify/openapi.yaml +++ b/src/libs/Speechify/openapi.yaml @@ -1 +1 @@ -{"openapi":"3.1.0","info":{"title":"API Reference","version":"1.0.0"},"paths":{"/v1/audio/speech":{"post":{"operationId":"speech","summary":"Create Speech","description":"Synthesize speech audio from text or SSML. Returns the complete audio\nfile plus billing and speech-mark metadata in a single JSON response.\nFor low-latency playback or long-form text, use POST /v1/audio/stream.\nSet `output_format` for explicit sample-rate/bitrate control (e.g.\n`pcm_16000` or `ulaw_8000` for telephony).","tags":["audio"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Synthesized speech audio for the requested input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSpeechResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSpeechRequest"}}}}}},"/v1/audio/stream":{"post":{"operationId":"stream","summary":"Stream Speech","description":"Synthesize speech and stream the audio back as it is generated, for\nlow-latency playback. Set `output_format` in the body for explicit\ncodec/sample-rate/bitrate control (e.g. `pcm_16000` or `ulaw_8000` for\ntelephony), or fall back to the Accept header for the container; the\nresponse is raw audio bytes (HTTP chunked). For Base64-encoded audio\nwith speech-mark metadata in a single JSON response, use\nPOST /v1/audio/speech.","tags":["audio"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"Selects the audio container/codec for the streamed response when\n`output_format` is not set in the request body. The response\nContent-Type echoes this value, except `audio/pcm` returns\n`audio/L16` with rate and channels parameters (raw 16-bit linear\nPCM, 24 kHz mono, little-endian). For explicit sample-rate/bitrate\ncontrol (e.g. `pcm_16000`, `ulaw_8000`), set `output_format` in the\nbody instead; it takes precedence over this header.","required":false,"schema":{"$ref":"#/components/schemas/V1AudioStreamPostParametersAccept"}}],"responses":{"200":{"description":"Streamed audio. When `output_format` is set it selects the\ncodec/sample rate; otherwise the Accept header does. The\nContent-Type reflects the selected format: it matches the Accept\nheader, except raw PCM returns `audio/L16` (with rate and channels\nparameters) and u-law returns `audio/basic`.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetStreamRequest"}}}}}},"/v1/audio/stream/with-timestamps":{"post":{"operationId":"streamWithTimestamps","summary":"Stream Speech With Timestamps","description":"Synthesize speech and stream it back together with word-level speech\nmarks, for text highlighting, captions and audio-text synchronization\nwhile the audio is still arriving.\n\nThe response is a Server-Sent Events stream. Each `speech.chunk` event\ncarries a Base64-encoded run of audio, the speech marks that became\nfinal with it, or both - a chunk may carry only one of the two, and the\nlast chunk of a stream is often marks-only. A terminal `speech.done`\nevent ends the stream; there is no `[DONE]` sentinel. Ignore any event\ntype you do not recognize, so that new event types do not break your\nintegration.\n\nSpeech-mark times are absolute milliseconds from the start of the\nsynthesis, so concatenate the audio chunks into one stream and apply the\nmarks against that single timeline. Which chunk a mark arrives on is a\ndelivery detail and carries no meaning. Times stay correct for every\n`output_format`: changing the codec or sample rate does not change the\nduration.\n\nSpeech marks are produced by the streaming-native models. The default\n`simba-3.0` and `simba-3.2` both serve this route. The legacy\n`simba-english` and `simba-multilingual` models never could: on a\nworkspace pinned before API version `2026-09-21` they return 400\n`speech_marks_unsupported` here, and from that version on they return\n400 `model_retired` on every synthesis route. Both are switched off\nentirely on 2026-11-21.\nFor Base64-encoded audio and speech marks in one non-streamed JSON\nresponse, on any model, use POST /v1/audio/speech.","tags":["audio"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","description":"Selects the audio container/codec carried inside the events when\n`output_format` is not set in the request body. The selected media\ntype is echoed on the `Speechify-Audio-Content-Type` response\nheader, since the response's own Content-Type is `text/event-stream`.","required":false,"schema":{"$ref":"#/components/schemas/V1AudioStreamWithTimestampsPostParametersAccept"}}],"responses":{"200":{"description":"A Server-Sent Events stream of `speech.chunk` events followed by one\nterminal `speech.done` event. A failure after the stream has started\nis delivered as a `speech.error` event carrying the standard error\nenvelope, because the status code is already committed.\n\nThe transport is `text/event-stream`: each event is an\n`event:`/`data:` pair whose `data` is one JSON payload matching the\nschema below. The payload's `type` field mirrors the `event:` name,\nso the stream is also parseable from `data:` lines alone. Ignore\nevent types you do not recognize.","content":{"text/event-stream":{"schema":{"$ref":"#/components/schemas/SpeechStreamEvent"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetStreamRequest"}}}}}},"/v1/voices":{"get":{"operationId":"list","summary":"List Voices","description":"Lists the voices available to the caller - the shared voice\ncatalog plus the cloned voices they can reach, whichever member or\nservice-account key created them. A clone filed under a project is\nlisted only for a caller who can reach that project; a clone no\nproject filed is shared with the whole workspace and is listed for\neveryone in it. By default\nthe full catalogue is returned in one response. Pagination is\nopt-in: pass `limit` (and then `cursor` from the previous\nresponse) to page through the list while `has_more` is true. Max\npage size is 200. Narrow the list with the `type` and `locale`\nfilters.\n\nA page can come back with fewer than `limit` voices, and a short\npage - an empty one included - is not the end of the list. Keep\nfollowing `next_cursor` while `has_more` is true.","tags":["voices"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"type","in":"query","description":"Filter by voice type: `personal` (the workspace's cloned voices)\nor `shared` (the public catalogue). Omit to return both.","required":false,"schema":{"$ref":"#/components/schemas/V1VoicesGetParametersType"}},{"name":"locale","in":"query","description":"Filter to voices whose locale matches this BCP-47 language range,\nprefix-matched: `en` matches `en-US` and `en-GB`; `en-US` matches\nonly `en-US`. Case-insensitive. Omit to return all locales.","required":false,"schema":{"type":"string"}},{"name":"gender","in":"query","description":"Filter by voice gender. Omit to return all genders.","required":false,"schema":{"$ref":"#/components/schemas/V1VoicesGetParametersGender"}},{"name":"model","in":"query","description":"Filter to voices that support this model (as listed in each voice's\n`models[]`), e.g. `simba-3.2`. Omit to return voices for all models.","required":false,"schema":{"type":"string"}},{"name":"project_id","in":"query","description":"Filter cloned voices by workspace project: omit for every voice you\ncan reach, pass the literal `shared` for the clones no project\nfiled, or a `proj_...` id for the clones filed under that project.\nThe shared catalog carries no project and is returned either way.\n\nA clone is filed under a project when a project-pinned key created\nit. A clone with no project is shared with the whole workspace\nrather than sitting in a Default project, so the literal here is\n`shared`, never `default` - passing `default` is a 400. Returns 404\nproject_not_found for a malformed id and for any project outside\nyour reach: a project-pinned key reaches only its pinned project,\nand a member holding project grants reaches only the granted ones.\nThat 404 is the same in every case and does not reveal whether such\na project exists. `shared` is always inside your reach.\n","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The voice catalogue (or a page of it when `limit` is set).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListVoicesResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"create","summary":"Create Voice","description":"Create a cloned voice for the workspace from a 10-30 second audio sample, with verified consent from the speaker.\n\nCloning requires proof that the speaker agreed to it. Create a consent challenge with `POST /v1/voices/consent-challenges`, show the returned `phrase` to the speaker, record them reading it aloud, and send that recording here as `consent_recording` together with the challenge's `consent_challenge_id`. Speechify transcribes the recording, checks it against the phrase it issued, checks that its speaker is the speaker in your `sample`, and keeps it as the consent record for the voice. The person consenting therefore has to be the person being cloned. A challenge is single use and short-lived, so record and submit in one sitting.\n\nThe clone belongs to the workspace rather than the member who created it, and access follows the caller's workspace role and API-key scopes exactly as for any other voice: voices scopes to list it, audio scopes to synthesize with it, and the content-management permission plus a write scope on the key to delete it. Cloned voices are usable self-serve on `simba-3.0` (and, on a workspace pinned before API version `2026-09-21`, on the retired `simba-english` and `simba-multilingual` until they are switched off on 2026-11-21). `simba-3.2` also serves cloned voices.\n\nCallers pinned before `Speechify-Version: 2026-09-13` use the previous flow instead: no challenge, and a `consent` form field carrying the speaker's name and email as a JSON string. That flow is deprecated and will be removed after a sunset window announced in the changelog.","tags":["voices"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"A client-generated key (an opaque string, max 255 chars) that makes a\nside-effect POST safe to retry: the server runs the operation exactly\nonce and replays the first response (its status and body) for 24 hours.\nReusing a key with a different request body, or while the first request\nis still in flight, returns `409 idempotency_conflict`. A replayed\nresponse carries the `Idempotent-Replayed: true` header.\n","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"201":{"description":"A created voice","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoice"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body exceeded a per-endpoint size limit (e.g. the file\nupload cap, KB document upload cap, batch-call CSV cap).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The request was well-formed but semantically rejected -\ntypically a referential integrity violation (e.g. flow node\nreferences an audio asset in another workspace) or a state\nmachine refusal.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name of the personal voice"},"locale":{"type":"string","default":"en-US","description":"Native language (locale) of the personal voice (e.g. en-US, es-ES, etc.)"},"gender":{"$ref":"#/components/schemas/V1VoicesPostRequestBodyContentMultipartFormDataSchemaGender","description":"Gender marker for the personal voice\nmale GenderMale\nfemale GenderFemale\nnot_specified GenderNotSpecified"},"sample":{"type":"string","format":"binary","description":"Audio sample of the voice to clone, 10-30 seconds of clean speech."},"avatar":{"type":"string","format":"binary","description":"Avatar image file"},"consent_challenge_id":{"type":"string","description":"The `id` of the consent challenge this create consumes, from\n`POST /v1/voices/consent-challenges`. Single use: once a\ncreate has consumed it, whether or not that create\nsucceeded, it cannot be used again."},"consent_recording":{"type":"string","format":"binary","description":"Recording of the speaker reading the challenge's `phrase`\naloud. This is the consent record for the voice, not a\nsecond voice sample: it must be the same person as in\n`sample`, and it is retained as evidence. 5-30 seconds, at\nmost 25 MB, in any common audio container."}},"required":["name","gender","sample","consent_challenge_id","consent_recording"]}}}}}},"/v1/voices/consent-challenges":{"post":{"operationId":"create","summary":"Create Consent Challenge","description":"Start the consent check for a voice clone.\n\nReturns a `phrase` for the speaker to read aloud and an `id` that identifies this challenge. Show the phrase to the speaker exactly as returned, record them reading it, then send the recording and the `id` to `POST /v1/voices`, which verifies the recording against the phrase and against the voice sample being cloned, then keeps it as the consent record.\n\nA challenge is single use, is bound to the workspace that created it, and expires at `expires_at` - it is proof that a speaker was in front of a microphone just now, so create it when you are ready to record, not at the start of your flow. If it expires, create another one and record again.\n\nChallenge creation is rate limited per workspace at a few dozen per hour, far more tightly than the rest of the voice surface, because each one precedes a person recording themselves - mint it when your speaker is ready, not speculatively. Read the live ceiling off `RateLimit-*` rather than hard-coding it. **On a `429`, always honour `Retry-After` rather than a fixed backoff of your own**: the wait is measured in minutes and can run to most of an hour. `RateLimit-*` are omitted rather than reporting a bucket that is not the one refusing.","tags":["consentChallenges"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"A client-generated key (an opaque string, max 255 chars) that makes a\nside-effect POST safe to retry: the server runs the operation exactly\nonce and replays the first response (its status and body) for 24 hours.\nReusing a key with a different request body, or while the first request\nis still in flight, returns `409 idempotency_conflict`. A replayed\nresponse carries the `Idempotent-Replayed: true` header.\n","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"201":{"description":"The created consent challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentChallenge"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConsentChallengeRequest"}}}}}},"/v1/voices/{voice_id}":{"get":{"operationId":"get","summary":"Get Voice","description":"Fetch a single voice by id - a shared catalogue voice or one of\nthe workspace's cloned voices. A cloned voice that belongs to\nanother workspace returns 404, identical to an unknown id, so\nvoice inventory is never enumerable across tenants.","tags":["voices"],"parameters":[{"name":"voice_id","in":"path","description":"The ID of the voice to fetch","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The voice.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVoice"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"delete","summary":"Delete Voice","description":"Delete one of the workspace's cloned voices. Requires the\n`content.manage` permission (owner, admin, or member); a\nservice-account key is authorized by its scopes instead.","tags":["voices"],"parameters":[{"name":"voice_id","in":"path","description":"The ID of the voice to delete","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Voice deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/voices/{voice_id}/sample":{"get":{"operationId":"downloadSample","summary":"Download Voice Sample","description":"Download a personal (cloned) voice sample","tags":["voices"],"parameters":[{"name":"voice_id","in":"path","description":"The ID of the voice to download sample for","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Voice sample audio file","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"A downstream dependency is degraded or the endpoint is\nintentionally disabled (e.g. phone-number purchase before\nops setup).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/audio/models":{"get":{"operationId":"list","summary":"List Models","description":"List the text-to-speech models available for synthesis. Drive a model\npicker from this response, then pass a model `id` as the `model`\nparameter to POST /v1/audio/speech or /v1/audio/stream. The response\nmarks the default model (used when a request omits `model`), the\nroutes each model may be passed to, and which voices it accepts.\nMulti-speaker models arrive in a separate `dialogue_models` array\nbecause they are valid only on POST /v1/audio/dialogue. Returns\nthe full set in a single response: the model catalog is static\nplatform reference data, so it is intentionally not paginated.","tags":["models"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The available text-to-speech models.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelsResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/audio/watermark/detect":{"post":{"operationId":"detect","summary":"Detect Watermark","description":"Check whether a clip carries the watermark Speechify seals into audio it\ngenerates. Upload the audio as `audio`; nothing about it is stored, and\nno voice is read or written.\n\nRead the answer carefully in one direction. A `watermarked: true` is\npositive evidence that the audio came from Speechify synthesis. A\n`watermarked: false` is NOT proof that it did not: only models\nredeployed since the watermark shipped mark their output, the detector\nneeds at least three seconds of clear speech to judge, and re-encoding\nor changing the speed of a clip degrades the mark. Treat a negative as\nthe absence of evidence rather than as evidence of absence.\n\nChecks are rate-limited well below the synthesis budget: this is a\nforensic question, not a data-plane call.","tags":["watermark"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The clip was checked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatermarkDetectionResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body exceeded a per-endpoint size limit (e.g. the file\nupload cap, KB document upload cap, batch-call CSV cap).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The request was well-formed but semantically rejected -\ntypically a referential integrity violation (e.g. flow node\nreferences an audio asset in another workspace) or a state\nmachine refusal.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"audio":{"type":"string","format":"binary","description":"The clip to check, at most 25MB. Give the detector at least\nthree seconds of clear speech; below that its confidence is\nnot worth acting on, and below half a second it always\nreports zero."}},"required":["audio"]}}}}}},"/v1/audio/watermark/verify":{"post":{"operationId":"verify","summary":"Verify Watermark","description":"The public AI detection tool. Ask whether a clip carries the watermark\nSpeechify seals into audio it generates, with no account, no API key and\nno credential of any kind.\n\n`verify` answers; `detect` measures. This route returns a bare yes or no,\nthe way verifying a signature does. Its sibling\n`POST /v1/audio/watermark/detect` takes an API key and returns the\ndetector's confidence alongside the verdict.\n\nThis is the programmatic half of the tool published at\n, and it exists so the tool can be invoked\nwithout visiting our website, as California's AI Transparency Act\n(BPC 22757.2) requires. Nothing about the clip is stored, and nothing\nidentifying about you is collected or retained.\n\nThe answer is a bare verdict. `watermarked: true` is positive evidence\nthat the audio came from Speechify synthesis. `watermarked: false` is\nNOT proof that it did not: only models redeployed since the watermark\nshipped mark their output, the detector needs at least three seconds of\nclear speech to judge, and re-encoding or changing the speed of a clip\ndegrades the mark. Treat a negative as the absence of evidence rather\nthan as evidence of absence.\n\nBecause the tool takes no credential, it is rate-limited per client\naddress and shares a platform-wide budget: expect a 429 under sustained\nautomated use, and retry after the interval the response advertises.\nUse `POST /v1/audio/watermark/detect` with an API key for the detector's\nconfidence score and a per-workspace allowance of its own.","tags":["watermark"],"parameters":[{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The clip was checked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatermarkVerificationResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Request body exceeded a per-endpoint size limit (e.g. the file\nupload cap, KB document upload cap, batch-call CSV cap).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The request was well-formed but semantically rejected -\ntypically a referential integrity violation (e.g. flow node\nreferences an audio asset in another workspace) or a state\nmachine refusal.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"An upstream dependency (the TTS composer or voice-metadata\nservice) returned a 5xx. The raw upstream detail is not\nforwarded - the cause is in the server log; the response is a\nfixed `upstream_failure` envelope. Safe to retry.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"audio":{"type":"string","format":"binary","description":"The clip to check, at most 25MB. Give the detector at least\nthree seconds of clear speech; below that its answer is not\nworth acting on."}},"required":["audio"]}}}}}},"/v1/agents":{"get":{"operationId":"list","summary":"List Agents","description":"List voice agents owned by the caller. Cursor-paginated: omit\n`cursor` for the first page; walk pages while `has_more` is true\n(default page size 50, max 200).","tags":["agent"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"project_id","in":"query","description":"Filter by workspace project: omit for every project you can reach,\npass the literal `default` for resources in the implicit Default\nproject only, or a `proj_...` id for that project's resources.\nReturns 404 project_not_found for a malformed id and for any filter\noutside your reach: a project-pinned API key or service-account key\nreaches only its pinned project, and a member holding project grants\nreaches only the granted projects, so neither can name `default`.\nThat 404 is the same in every case and does not reveal whether such\na project exists - outside your reach a project is answered as\nnonexistent, never as forbidden. Inside it, a well-formed id that\nmatches no project yields an empty page.\n","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A list of voice agents.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAgentsResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"create","summary":"Create Agent","description":"Create a voice agent.\n\nThe agent lands in the project named by `project_id`, or in the\nimplicit Default project when none is given. Each project holds at\nmost a fixed number of live agents; a create past that answers\n`409 agent_limit_reached` naming the ceiling, and deleting an agent\nin that project - or creating this one in another - frees a slot.\n","tags":["agent"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"201":{"description":"The created agent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentRequest"}}}}}},"/v1/agents/voices":{"get":{"operationId":"listAgentVoices","summary":"List Agent Voices","description":"List the voice catalogue available for voice agents: the curated\nshared catalogue plus your workspace's own cloned voices, each\nmarked by `type` (`shared` or `personal`). The same slug set is\naccepted by POST/PATCH /v1/agents, so any voice listed here can be\nassigned to an agent. Cloned voices are workspace-owned only - a\npersonal voice scoped to an individual is not selectable on an\nagent, which is a workspace-shared resource. The JSON layout\nintentionally mirrors the TTS `/v1/voices` shape so a single voice\npicker can consume both endpoints.\n\nCursor-paginated: pass `cursor` + `limit` and walk pages while\n`has_more` is true. From API version `2026-08-07` an omitted `limit`\nreturns the first page (default 50, max 200); a caller pinned before\nthat date keeps the historical whole-catalogue response until it opts\nin. The shared catalogue is served first, then your cloned voices.\n","tags":["agent"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The curated agent voice catalogue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAgentVoicesResponse"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/tts-models":{"get":{"operationId":"listTTSModels","summary":"List Agent TTS Models","description":"List the Simba text-to-speech models a voice agent can be pinned to\nwith `tts.model`.\n\nThe response is the whole catalog and is the same for every\nworkspace - which model serves an agent is a routing decision, not\nan entitlement, so nothing here is plan-gated. Whether a *particular*\nagent may select an entry depends on two facts this response\npublishes rather than resolving for you, because both change without\nthis list changing:\n\n- `english_only` - the model has no multilingual deployment, so an\n agent that declares `additional_languages` (or whose `language` is\n not English) cannot select it.\n- `requires_voice_curation` - deprecated and always false. No model\n asks a voice for a registration: every training conditions on the\n voice's own prompt audio, so every model is selectable on every\n voice we speak ourselves, cloned voices included.\n\nDrive a model picker from this and the agent's languages and it can\nonly offer combinations POST/PATCH /v1/agents will accept.\nReturns the full set in one response: bounded by the platform's\ncurated model catalog, so it is intentionally not paginated.\n","tags":["agent"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The TTS models selectable for voice agents.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTTSModelsResponse"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/{agent_id}":{"delete":{"operationId":"delete","summary":"Delete Agent","description":"Delete an agent, and with it everything that belonged only to that\nagent.\n\n**Goes with the agent**, immediately unreadable through every\nendpoint: its runs and their step journals and approvals, its\nconversations and the transcripts, messages and recordings inside\nthem, what it learned about the people it spoke to, its triggers,\nshare links, channel bindings, team memberships and the batch\ncampaigns it dialled. A run that has not settled is asked to stop,\nincluding one parked waiting on a person or on a delegated child. These are removed for good 30 days\nlater; until then the delete can still be walked back by support.\n\n**Survives the agent**, because it belongs to the workspace rather\nthan to this agent: attached tools, knowledge bases, stores and\nskills (only the attachment is dropped), the agent's tests, phone\nnumbers, and the teams it belonged to.\n\n**Kept regardless**, because it is accounting rather than content:\nthe usage the workspace was billed for.\n\nRefused with `409 agent_in_use` while a live phone number still\nroutes to the agent, including the agent a webhook binding\nprovisioned for its number; `used_by` names the numbers. Unbind them\n(`DELETE /v1/agents/{agent_id}/phone-numbers/{phone_number_id}`,\nwhich also clears a webhook binding) and the delete proceeds.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Agent deleted.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"A live phone number still routes to the agent. `used_by` names\nthem so the caller can unbind first.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentInUseError"}}}}}},"get":{"operationId":"get","summary":"Get Agent","description":"Retrieve a voice agent by ID.","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The requested agent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"update","summary":"Update Agent","description":"Update a voice agent. Only fields present on the request body are changed.","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated agent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentRequest"}}}}}},"/v1/agents/{agent_id}/widget-config":{"get":{"operationId":"getWidgetConfig","summary":"Get Agent Widget Config","description":"Return the embed-widget appearance config for an agent. Works\nunauthenticated for public agents; the body is cosmetic only.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The agent's widget configuration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfig"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/flow/schema":{"get":{"operationId":"getSchema","summary":"Get Flow Graph Schema","description":"Return the JSON Schema describing the flow graph node taxonomy.\nUnauthenticated; flow editors fetch it to validate graphs client-side.\n","tags":["flow"],"parameters":[{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A JSON Schema document for the flow graph.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/agent_flow_getSchema_Response_200"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/{agent_id}/flow":{"get":{"operationId":"getFlow","summary":"Get Agent Flow","description":"Return the agent's flow graph: the current draft (if any), the\nactive published graph (if any), and the version history.\n","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The draft graph, active graph, and version history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFlowResponse"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"updateFlow","summary":"Update Agent Flow Draft","description":"Replace the agent's draft flow graph. The graph is validated\nbefore it is stored; publish it separately to make it active.\n","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The stored draft graph.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowGraph"}}}},"400":{"description":"Flow validation failed (or the request body was undecodable). The\nstandard `Error` envelope plus an `issues` array locating each problem\nfor the editor. See the `FlowValidationError` schema.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationError"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PutFlowRequest"}}}}}},"/v1/agents/{agent_id}/flow/publish":{"post":{"operationId":"publish","summary":"Publish Agent Flow","description":"Publish the agent's draft graph as a new active flow version.","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The newly published flow version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowVersion"}}}},"400":{"description":"Flow validation failed (or the request body was undecodable). The\nstandard `Error` envelope plus an `issues` array locating each problem\nfor the editor. See the `FlowValidationError` schema.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationError"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The behavioral-eval publish gate refused the publish, on one of two\ncodes the caller can FIX (neither is waited out):\n\n- `agent_publish_gate_failed`: the agent's configured suite did not\n pass. `error.details` carries the verdict (per-case, per-criterion).\n- `agent_publish_gate_tool_unreachable`: the checks never ran because\n a tool the agent is attached to could not be reached. Nothing was\n judged, and no retry helps while the endpoint is down;\n `error.message` names the tool, the endpoint and the reason.\n\nThe one publish failure that IS waited out is the `503`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The publish checks could not run (`agent_publish_gate_unavailable`):\nthe eval worker, the judge or the probe corpus errored, so nothing\nabout the agent was judged. This is OURS, and the only publish failure\na caller waits out: not a verdict on the configuration, retry after\n`Retry-After`. `error.details` lists the cases that could not run. A\ncheck that could not run because of the agent's own configuration is\nthe `422 agent_publish_gate_tool_unreachable` instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishFlowRequest"}}}}}},"/v1/agents/{agent_id}/flow/rollback":{"post":{"operationId":"rollback","summary":"Roll Back Agent Flow","description":"Publish a prior flow version as the active graph.","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The flow version that is now active.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowVersion"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"The behavioral-eval publish gate refused the rollback, on one of two\ncodes the caller can FIX (neither is waited out):\n\n- `agent_publish_gate_failed`: the target version did not pass the\n agent's configured suite. `error.details` carries the verdict.\n- `agent_publish_gate_tool_unreachable`: the checks never ran because\n a tool the agent is attached to could not be reached;\n `error.message` names the tool, the endpoint and the reason.\n\nThe one rollback failure that IS waited out is the `503`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"The gate's checks could not run on the rollback target\n(`agent_publish_gate_unavailable`): the eval worker, the judge or\nthe probe corpus errored, so nothing about the version was judged.\nThis is OURS, and the only rollback failure a caller waits out: not a\nverdict on it, retry after `Retry-After`. `error.details` lists the\ncases that could not run. A check that could not run because of the\nagent's own configuration is the `422\nagent_publish_gate_tool_unreachable` instead.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RollbackFlowRequest"}}}}}},"/v1/agents/{agent_id}/flow/deactivate":{"post":{"operationId":"deactivate","summary":"Deactivate Agent Flow","description":"Deactivate the agent's published flow so the agent runs the synthesized default flow.","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Flow deactivated.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/{agent_id}/flow/draft":{"delete":{"operationId":"discardDraft","summary":"Discard Agent Flow Draft","description":"Discard the agent's unpublished draft flow graph.","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Draft discarded.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/{agent_id}/flow/versions":{"get":{"operationId":"listVersions","summary":"List Agent Flow Versions","description":"List every published flow version for the agent, newest first.\nCursor-paginated: omit `cursor` for the first page; walk pages\nwhile `has_more` is true (default page size 50, max 200).","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The agent's flow version history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFlowVersionsResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/{agent_id}/flow/versions/{version_id}":{"get":{"operationId":"getVersion","summary":"Get Agent Flow Version","description":"Return the full flow graph for a specific published version.","tags":["flow"],"parameters":[{"name":"agent_id","in":"path","description":"Prefixed agent id.","required":true,"schema":{"type":"string"}},{"name":"version_id","in":"path","description":"Prefixed flow version id (`fver_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The requested flow version's graph.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowGraph"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/flow/templates":{"get":{"operationId":"listTemplates","summary":"List Flow Templates","description":"List the reusable flow templates available to the workspace.\nCursor-paginated: omit `cursor` for the first page; walk pages\nwhile `has_more` is true (default page size 50, max 200).","tags":["flow"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The available flow templates.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFlowTemplatesResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createTemplate","summary":"Create Flow Template","description":"Create a reusable flow template from a graph.","tags":["flow"],"parameters":[{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"201":{"description":"The created flow template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowTemplate"}}}},"400":{"description":"Flow validation failed (or the request body was undecodable). The\nstandard `Error` envelope plus an `issues` array locating each problem\nfor the editor. See the `FlowValidationError` schema.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationError"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFlowTemplateRequest"}}}}}},"/v1/agents/flow/templates/{flow_template_id}":{"get":{"operationId":"getTemplate","summary":"Get Flow Template","description":"Retrieve a flow template by id.","tags":["flow"],"parameters":[{"name":"flow_template_id","in":"path","description":"Flow template id (prefixed external id, `tmpl_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The requested flow template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowTemplate"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"updateTemplate","summary":"Update Flow Template","description":"Replace a flow template. The whole template is replaced, not patched field-by-field.","tags":["flow"],"parameters":[{"name":"flow_template_id","in":"path","description":"Flow template id (prefixed external id, `tmpl_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated flow template.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowTemplate"}}}},"400":{"description":"Flow validation failed (or the request body was undecodable). The\nstandard `Error` envelope plus an `issues` array locating each problem\nfor the editor. See the `FlowValidationError` schema.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationError"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFlowTemplateRequest"}}}}},"delete":{"operationId":"deleteTemplate","summary":"Delete Flow Template","description":"Delete a flow template.","tags":["flow"],"parameters":[{"name":"flow_template_id","in":"path","description":"Flow template id (prefixed external id, `tmpl_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Template deleted.","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/flow/templates/{flow_template_id}/clone":{"post":{"operationId":"cloneTemplate","summary":"Clone Flow Template","description":"Clone a flow template onto an agent as a new draft graph.","tags":["flow"],"parameters":[{"name":"flow_template_id","in":"path","description":"Flow template id (prefixed external id, `tmpl_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The agent's new draft graph.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowGraph"}}}},"400":{"description":"Flow validation failed (or the request body was undecodable). The\nstandard `Error` envelope plus an `issues` array locating each problem\nfor the editor. See the `FlowValidationError` schema.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowValidationError"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"An unexpected server-side error occurred. Safe to retry with\nexponential backoff for idempotent requests.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloneFlowTemplateRequest"}}}}}},"/v1/agents/{agent_id}/evaluation-config":{"get":{"operationId":"getEvaluationConfig","summary":"Get Evaluation Config","description":"Retrieve the agent's post-call evaluation criteria + data-collection config.","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The evaluation config for the agent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationConfig"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"updateEvaluationConfig","summary":"Update Evaluation Config","description":"Replace the agent's evaluation criteria + data-collection fields.","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated evaluation config.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationConfig"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEvaluationConfigRequest"}}}}}},"/v1/agents/{agent_id}/variables":{"get":{"operationId":"getDynamicVariables","summary":"Get Dynamic Variables","description":"Retrieve the agent's customer-scope dynamic variables and the read-only\ncatalogue of reserved `system__*` keys. The system variables list is\nprovided so editor UIs can render the reference list without maintaining\na client-side copy of the catalogue.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The agent's variable catalogue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDynamicVariablesResponse"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"updateDynamicVariables","summary":"Update Dynamic Variables","description":"Replace the agent's customer-scope dynamic variable definitions.\nThe supplied list overwrites the stored list wholesale (same\nsemantics as `updateEvaluationConfig`). Pass an empty array to\nclear all variables. Up to 20 variables per agent. Keys must\nmatch `[a-zA-Z0-9_]+` and must not start with the reserved\n`system__` prefix.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The updated variable catalogue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDynamicVariablesResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDynamicVariablesRequest"}}}}}},"/v1/agents/{agent_id}/conversations":{"post":{"operationId":"createConversation","summary":"Create Conversation","description":"Start a new voice conversation with the agent. Returns a realtime\nvoice session + short-lived client token so the caller can\nconnect the audio pipeline directly. The agent is dispatched\nserver-side; no additional client action required.\n\nPass `dynamic_variables` to supply per-session values that override\nthe agent's stored variable defaults for this one conversation.\nKeys in the `system__` namespace are rejected at this boundary.\n\nPass `user_identity` as the stable caller key your application uses\nfor memory and caller correlation. It is kept separate from the\nopaque, per-session realtime participant identity.\n\n`overrides.voice_id` replaces the configured voice for the entire\nconversation, including every configured language the voice can\nserve. The request is rejected when the voice is unavailable or\ncannot cover the agent's configured language set; the rejection\nnames `overrides.voice_id` in the error envelope's `fields` map.\nThe override belongs to this conversation only: if the call is\ntransferred to another agent mid-conversation, that agent speaks\nwith its own configured voice.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"A client-generated key (an opaque string, max 255 chars) that makes a\nside-effect POST safe to retry: the server runs the operation exactly\nonce and replays the first response (its status and body) for 24 hours.\nReusing a key with a different request body, or while the first request\nis still in flight, returns `409 idempotency_conflict`. A replayed\nresponse carries the `Idempotent-Replayed: true` header.\n","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"201":{"description":"The created conversation with its realtime session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversationResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversationRequest"}}}}}},"/v1/agents/{agent_id}/sessions":{"post":{"operationId":"createSession","summary":"Create Session","description":"Mint a realtime voice session for the given agent. Widget-friendly\ncounterpart to `createConversation` \u2014 same response shape, dual\nauthentication:\n\n* **Authenticated (Bearer)**: works for any agent the caller\n owns. Typical server-to-server flow where the embedding\n site's backend mints a token and hands it to the browser so\n the API key never reaches the client.\n* **Unauthenticated**: works only when `agent.is_public = true`\n AND the request's `Origin` header matches `agent.allowed_origins`\n (or that list is empty). When `agent.hostname_allowlist` is\n non-empty, the `Origin` hostname must additionally be a\n member of that list. Used directly by the\n `` web component.\n\nResponds with the same `CreateConversationResponse` as\n`createConversation`.\n\n`Idempotency-Key` replay is scoped to the authenticated caller, so it\napplies to Bearer requests only: an unauthenticated mint has no scope\nto replay under, and retrying one mints a fresh session.\n","tags":["agent"],"parameters":[{"name":"agent_id","in":"path","description":"Agent id (prefixed external id, `agent_...`).","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","description":"A client-generated key (an opaque string, max 255 chars) that makes a\nside-effect POST safe to retry: the server runs the operation exactly\nonce and replays the first response (its status and body) for 24 hours.\nReusing a key with a different request body, or while the first request\nis still in flight, returns `409 idempotency_conflict`. A replayed\nresponse carries the `Idempotent-Replayed: true` header.\n","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"201":{"description":"The created session with its realtime token + URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversationResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"The workspace has insufficient credits, or the request needs a\nplan tier the workspace is not on (e.g. voice cloning). Distinct\nfrom `Forbidden` so SDK consumers can drive upgrade UX.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The credential authenticated, but is not authorised for this\nresource - typically a workspace-role gate (owner / admin\nrequired) or a cross-tenant access attempt.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"The request conflicts with the current resource state - e.g.\nduplicate, optimistic-concurrency mismatch, or last-owner\nguard.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or concurrency limit exceeded. `error.code` says which\nceiling, and they need different responses: `rate_limited` is the\nrequest-rate budget (slow down), `concurrency_limit_reached` is a\nworkspace-wide concurrency ceiling (fewer at once, or raise it), and\n`conversation_turn_in_progress` is contention over one named\nconversation (keep one message in flight on it). Every 429 carries\n`Retry-After` and the request-rate budget headers; the active-call cap\nalso carries `RateLimit-Remaining-Calls: 0`.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSessionRequest"}}}}}},"/v1/agents/conversations":{"get":{"operationId":"list","summary":"List Conversations","description":"List conversations owned by the caller, ordered by most recent.\nCursor-paginated: omit `cursor` to fetch the first page; pass the\nprevious response's `next_cursor` back to fetch the next page.\nWalk pages while `has_more` is true.\n\n`project_id` matches the project the call was DISPATCHED under, which\nis frozen when the conversation starts. Moving an agent to another\nproject therefore leaves its past calls attributed where they ran, the\nsame way per-project usage reports them.","tags":["conversations"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"agent_id","in":"query","description":"Filter to conversations for this agent.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by conversation status.","required":false,"schema":{"$ref":"#/components/schemas/ConversationStatus"}},{"name":"transport","in":"query","description":"Filter by the runtime that carried the conversation. `phone`\nmatches calls in either direction.\n","required":false,"schema":{"$ref":"#/components/schemas/ConversationTransport"}},{"name":"channel","in":"query","description":"Filter by the front door the conversation arrived through.\nThis is the axis that separates two conversations sharing one\ntransport: `channel=slack` and `channel=text` both run the\n`text` transport. Combining it with `transport` narrows by\nboth.\n","required":false,"schema":{"$ref":"#/components/schemas/ConversationChannel"}},{"name":"live","in":"query","description":"Narrow to (`true`) or away from (`false`) the conversations that\nare a realtime session in progress: non-terminal AND holding a\nroom. A text or Slack thread holds no room, so it is open rather\nthan live however long it stays non-terminal - `status=active`\nalone matches it. This is the filter a live view asks for.\n","required":false,"schema":{"type":"boolean"}},{"name":"caller_identity","in":"query","description":"Filter by caller identity.","required":false,"schema":{"type":"string"}},{"name":"contact_id","in":"query","description":"Narrow to one person's conversations, whichever agent or channel\nreached them. Prefixed `contact_...` id.\n","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Free-text search across conversation content.","required":false,"schema":{"type":"string"}},{"name":"started_after","in":"query","description":"Only conversations started at or after this RFC 3339 timestamp.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"started_before","in":"query","description":"Only conversations started at or before this RFC 3339 timestamp.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"duration_min_ms","in":"query","description":"Minimum conversation duration in milliseconds.","required":false,"schema":{"type":"integer"}},{"name":"duration_max_ms","in":"query","description":"Maximum conversation duration in milliseconds.","required":false,"schema":{"type":"integer"}},{"name":"project_id","in":"query","description":"Filter by workspace project: omit for every project you can reach,\npass the literal `default` for resources in the implicit Default\nproject only, or a `proj_...` id for that project's resources.\nReturns 404 project_not_found for a malformed id and for any filter\noutside your reach: a project-pinned API key or service-account key\nreaches only its pinned project, and a member holding project grants\nreaches only the granted projects, so neither can name `default`.\nThat 404 is the same in every case and does not reveal whether such\na project exists - outside your reach a project is answered as\nnonexistent, never as forbidden. Inside it, a well-formed id that\nmatches no project yields an empty page.\n","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A list of conversations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListConversationsResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/conversations/{conversation_id}":{"get":{"operationId":"get","summary":"Get Conversation","description":"Retrieve a conversation by ID.","tags":["conversations"],"parameters":[{"name":"conversation_id","in":"path","description":"Conversation id (prefixed external id, `conv_...`).","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The requested conversation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/conversations/recent-callees":{"get":{"operationId":"recent_callees","summary":"List recent callees","description":"Distinct phone numbers the caller's workspace has dialled on\noutbound calls, ordered by most recent. Feeds the batch-calls\ncomposer's \"Suggested from history\" surface. Cursor-paginated:\nomit `cursor` to fetch the first page. Default page size is 50\nand max is 200. Walk pages while `has_more` is true.\n","tags":["conversations"],"parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Recent callees for the caller's workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListRecentCalleesResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/conversations/stats":{"get":{"operationId":"stats","summary":"Conversation stats","description":"Aggregated counts and averages over the caller's conversations, scoped\nby the same filters as the list endpoint, `project_id` included.","tags":["conversations"],"parameters":[{"name":"agent_id","in":"query","description":"Filter to conversations for this agent.","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by conversation status.","required":false,"schema":{"$ref":"#/components/schemas/ConversationStatus"}},{"name":"transport","in":"query","description":"Filter by the runtime that carried the conversation. `phone`\nmatches calls in either direction.\n","required":false,"schema":{"$ref":"#/components/schemas/ConversationTransport"}},{"name":"channel","in":"query","description":"Filter by the front door the conversation arrived through.\nThis is the axis that separates two conversations sharing one\ntransport: `channel=slack` and `channel=text` both run the\n`text` transport. Combining it with `transport` narrows by\nboth.\n","required":false,"schema":{"$ref":"#/components/schemas/ConversationChannel"}},{"name":"live","in":"query","description":"Narrow to (`true`) or away from (`false`) the conversations that\nare a realtime session in progress: non-terminal AND holding a\nroom. A text or Slack thread holds no room, so it is open rather\nthan live however long it stays non-terminal - `status=active`\nalone matches it. This is the filter a live view asks for.\n","required":false,"schema":{"type":"boolean"}},{"name":"caller_identity","in":"query","description":"Filter by caller identity.","required":false,"schema":{"type":"string"}},{"name":"contact_id","in":"query","description":"Narrow to one person's conversations, whichever agent or channel\nreached them. Prefixed `contact_...` id.\n","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Free-text search across conversation content.","required":false,"schema":{"type":"string"}},{"name":"started_after","in":"query","description":"Only conversations started at or after this RFC 3339 timestamp.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"started_before","in":"query","description":"Only conversations started at or before this RFC 3339 timestamp.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"duration_min_ms","in":"query","description":"Minimum conversation duration in milliseconds.","required":false,"schema":{"type":"integer"}},{"name":"duration_max_ms","in":"query","description":"Maximum conversation duration in milliseconds.","required":false,"schema":{"type":"integer"}},{"name":"project_id","in":"query","description":"Filter by workspace project: omit for every project you can reach,\npass the literal `default` for resources in the implicit Default\nproject only, or a `proj_...` id for that project's resources.\nReturns 404 project_not_found for a malformed id and for any filter\noutside your reach: a project-pinned API key or service-account key\nreaches only its pinned project, and a member holding project grants\nreaches only the granted projects, so neither can name `default`.\nThat 404 is the same in every case and does not reveal whether such\na project exists - outside your reach a project is answered as\nnonexistent, never as forbidden. Inside it, a well-formed id that\nmatches no project yields an empty page.\n","required":false,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Stats for the matched conversations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationStats"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/conversations/{conversation_id}/messages":{"get":{"operationId":"listMessages","summary":"List Messages","description":"Retrieve the transcript for a conversation in started_at order\n(oldest first). Cursor-paginated: omit `cursor` to fetch the\nfirst page. Default page size is 50 and max is 200. Walk pages\nwhile `has_more` is true.","tags":["conversations"],"parameters":[{"name":"conversation_id","in":"path","description":"Conversation id (prefixed external id, `conv_...`).","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"Opaque pagination cursor from a previous response.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max items per page (default 50, max 200).","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Authorization","in":"header","description":"Enter your API key with the `Bearer` prefix, e.g. 'Bearer sk_...'.","required":true,"schema":{"type":"string"}},{"name":"Speechify-Version","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The messages for the conversation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMessagesResponse"}}}},"400":{"description":"The request was malformed or failed validation. The response\nbody is the standard `Error` envelope; for validation\nfailures `error.fields` enumerates the offending fields as\na `path -> message` map (code = `validation_failed`).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Authentication is missing or invalid. The request did not\ncarry a recognised credential (console session token, API key,\nor worker JWT).\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The referenced resource does not exist or is not visible to\nthe caller's workspace.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agents/conversations/{conversation_id}/recording":{"get":{"operationId":"streamRecording","summary":"Stream Recording","description":"Proxy the GCS-stored audio recording for a conversation through\nthe Cloud Run service identity. Returns OGG/Opus bytes (LiveKit\nroom-composite egress default). The response is streamed so a\nlong recording does not buffer in memory; `