linkbreakers 1.179.0 → 1.181.0

package/dist/apis/MediaApi.d.ts

@@ -2,7 +2,7 @@
  * Linkbreakers API
  * This is a documentation of all the APIs of Linkbreakers  ## Entry points  `GET https://api.linkbreakers.com/` and `GET https://api.linkbreakers.com/v1` answer without credentials with the API\'s name, version and links. This document is served at `https://api.linkbreakers.com/openapi.json`.  ## Rate limits  Every response describes where the caller stands in the IETF `RateLimit-Policy` and `RateLimit` header fields (draft-ietf-httpapi-ratelimit-headers), and in `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` and `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (a Unix timestamp) for clients that read those. A request past the limit gets `429 Too Many Requests` with `Retry-After` in seconds.  - Workspace API token: 600 requests per 60 seconds, per token. - Dashboard session or OAuth token: 500 requests per 60 seconds, per token. - No credentials: 300 requests per 60 seconds, per client IP.  Each plan also includes a number of API calls per billing cycle. Past it, calls answer `429` with the code `MAX_PUBLIC_API_QUERIED_REACHED` until the cycle renews or the plan changes.  ## Pagination  Every list pages with opaque cursors (AIP-158). Pass `pageSize`, then send the `nextPageToken` of each response back as `pageToken` (or its alias `cursor`) to get the next page. An empty or absent `nextPageToken` means the list is complete. Each list operation describes this in `x-pagination`.  ## Batches and background jobs  `POST /v1/links/bulk` creates up to 250 links in one transactional request; `POST /v1/links/batch` takes the same links as a bare JSON array. `POST /v1/links/bulk/jobs` accepts the same batch and answers `202 Accepted` at once with a job and a `Location` header; poll `GET /v1/jobs/{id}` until `status` is `JOB_STATUS_SUCCEEDED` (the created link ids are in `linksBulkCreate.linkIds`) or `JOB_STATUS_FAILED` (`error` says why, and nothing was created). Jobs can be read for 24 hours after they finish.  ## Versioning and deprecation  The version is in the path: every operation lives under `/v1`. Within a version, changes are additive only: new operations, new optional request fields, new response fields and new enum values. Clients should ignore fields and enum values they do not know. Anything that would break an existing client ships under a new path version instead.  An operation is retired in two steps. First it is deprecated: it keeps working, is flagged `deprecated: true` in this document, and every response carries a `Deprecation` header field (RFC 9745) with the time it was deprecated and a `Link` with `rel=\"deprecation\"` to the policy. Then, at least 180 days later, it may be removed; that date is announced in advance in a `Sunset` header field (RFC 8594) and as `x-sunset` on the operation. The full policy: https://linkbreakers.com/help/article/api-versioning-and-deprecation-policy  ## Idempotent retries  Every POST, PUT and PATCH accepts an optional `Idempotency-Key` header (draft-ietf-httpapi-idempotency-key-header). Send a new unique value, such as a UUID, with each logical request and reuse it only to retry that request. A retry with the same key and the same request returns the first response, marked `Idempotent-Replayed: true`, instead of running again. Keys are scoped to the token and kept for 24 hours. The same key with a different request is refused with `422`, and a retry while the first request is still running gets `409` with `Retry-After`. Server errors (5xx) and refusals such as 401, 403 and 429 are not stored, so retrying them runs the request again.
  *
- * The version of the OpenAPI document: 1.179.0
+ * The version of the OpenAPI document: 1.181.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,13 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CompleteMediaUploadResponse, CreateMediaRequest, CreateMediaResponse, CreateMediaUploadRequest, CreateMediaUploadResponse, GetMediaResponse, ImportMediaRequest, ImportMediaResponse, ListMediaResponse } from '../models/index';
+import type { CompleteMediaReplaceResponse, CompleteMediaUploadResponse, CreateMediaReplaceUploadResponse, CreateMediaRequest, CreateMediaResponse, CreateMediaUploadRequest, CreateMediaUploadResponse, GetMediaResponse, ImportMediaRequest, ImportMediaResponse, ListMediaResponse, MediaServiceCreateReplaceUploadBody, MediaServiceReplaceImportBody, ReplaceMediaImportResponse } from '../models/index';
+export interface MediaServiceCompleteReplaceRequest {
+    id: string;
+    replacementId: string;
+    body: object;
+    idempotencyKey?: string;
+}
 export interface MediaServiceCompleteUploadRequest {
     id: string;
     body: object;
@@ -20,6 +26,11 @@ export interface MediaServiceCreateRequest {
     createMediaRequest: CreateMediaRequest;
     idempotencyKey?: string;
 }
+export interface MediaServiceCreateReplaceUploadRequest {
+    id: string;
+    mediaServiceCreateReplaceUploadBody: MediaServiceCreateReplaceUploadBody;
+    idempotencyKey?: string;
+}
 export interface MediaServiceCreateUploadRequest {
     createMediaUploadRequest: CreateMediaUploadRequest;
     idempotencyKey?: string;
@@ -42,6 +53,11 @@ export interface MediaServiceListRequest {
     uploadedFrom?: string;
     cursor?: string;
 }
+export interface MediaServiceReplaceImportRequest {
+    id: string;
+    mediaServiceReplaceImportBody: MediaServiceReplaceImportBody;
+    idempotencyKey?: string;
+}
 /**
  * MediaApi - interface
  *
@@ -49,6 +65,33 @@ export interface MediaServiceListRequest {
  * @interface MediaApiInterface
  */
 export interface MediaApiInterface {
+    /**
+     * Creates request options for mediaServiceCompleteReplace without sending the request
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {string} replacementId The replacement\'s id (UUID), from CreateReplaceUpload
+     * @param {object} body
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceCompleteReplaceRequestOpts(requestParameters: MediaServiceCompleteReplaceRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Checks the new file PUT to the replacement\'s upload_url like CompleteUpload does (its size, its real format read from its first bytes, its SHA-256 established by the server), checks again that every use rendered from the media accepts it and that it fits the storage allowance, then swaps it in. The media keeps its id and takes the new file\'s name, MIME type, kind, size and sha256; its old file is deleted. QR code designs that used the media as their logo keep their current logo and are detached from it; they are returned in detached_references. On any refusal the new file is discarded and the media keeps its current file. A new file identical to the media\'s own changes nothing and returns unchanged true.  Requires the `media:write` scope.
+     * @summary Complete replacing a media file
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {string} replacementId The replacement\&#39;s id (UUID), from CreateReplaceUpload
+     * @param {object} body
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceCompleteReplaceRaw(requestParameters: MediaServiceCompleteReplaceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompleteMediaReplaceResponse>>;
+    /**
+     * Checks the new file PUT to the replacement\'s upload_url like CompleteUpload does (its size, its real format read from its first bytes, its SHA-256 established by the server), checks again that every use rendered from the media accepts it and that it fits the storage allowance, then swaps it in. The media keeps its id and takes the new file\'s name, MIME type, kind, size and sha256; its old file is deleted. QR code designs that used the media as their logo keep their current logo and are detached from it; they are returned in detached_references. On any refusal the new file is discarded and the media keeps its current file. A new file identical to the media\'s own changes nothing and returns unchanged true.  Requires the `media:write` scope.
+     * Complete replacing a media file
+     */
+    mediaServiceCompleteReplace(requestParameters: MediaServiceCompleteReplaceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompleteMediaReplaceResponse>;
     /**
      * Creates request options for mediaServiceCompleteUpload without sending the request
      * @param {string} id The ID of the pending media item (UUID), from CreateUpload
@@ -59,7 +102,7 @@ export interface MediaApiInterface {
      */
     mediaServiceCompleteUploadRequestOpts(requestParameters: MediaServiceCompleteUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  Requires the `media:write` scope.
+     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  The server always establishes the file\'s SHA-256 itself, from the checksum storage verified or by reading the file back. A file the workspace already holds is discarded with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names the existing media in existingMediaId and existingFileName. Use that media instead.  Requires the `media:write` scope.
      * @summary Complete a direct media upload
      * @param {string} id The ID of the pending media item (UUID), from CreateUpload
      * @param {object} body
@@ -70,7 +113,7 @@ export interface MediaApiInterface {
      */
     mediaServiceCompleteUploadRaw(requestParameters: MediaServiceCompleteUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompleteMediaUploadResponse>>;
     /**
-     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  Requires the `media:write` scope.
+     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  The server always establishes the file\'s SHA-256 itself, from the checksum storage verified or by reading the file back. A file the workspace already holds is discarded with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names the existing media in existingMediaId and existingFileName. Use that media instead.  Requires the `media:write` scope.
      * Complete a direct media upload
      */
     mediaServiceCompleteUpload(requestParameters: MediaServiceCompleteUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompleteMediaUploadResponse>;
@@ -83,7 +126,7 @@ export interface MediaApiInterface {
      */
     mediaServiceCreateRequestOpts(requestParameters: MediaServiceCreateRequest): Promise<runtime.RequestOpts>;
     /**
-     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  Requires the `media:write` scope.
+     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * @summary Upload a media file
      * @param {CreateMediaRequest} createMediaRequest
      * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
@@ -93,10 +136,35 @@ export interface MediaApiInterface {
      */
     mediaServiceCreateRaw(requestParameters: MediaServiceCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaResponse>>;
     /**
-     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  Requires the `media:write` scope.
+     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Upload a media file
      */
     mediaServiceCreate(requestParameters: MediaServiceCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaResponse>;
+    /**
+     * Creates request options for mediaServiceCreateReplaceUpload without sending the request
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {MediaServiceCreateReplaceUploadBody} mediaServiceCreateReplaceUploadBody
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceCreateReplaceUploadRequestOpts(requestParameters: MediaServiceCreateReplaceUploadRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Starts replacing the file of an existing media item with a new one uploaded straight to storage. The media keeps its id, so everything using it follows: Open media steps hand out the new file and page themes show it as their background cover, badge or footer logo from the next visit. Declare the new file\'s name, MIME type and exact size in bytes, and optionally its sha256. Then PUT its bytes to upload_url with the upload_headers before upload_expires_at, and call CompleteReplace with the replacement_id. Until then the media is unchanged; a replacement not completed within an hour is discarded.  The new file must be acceptable to every use rendered from the media\'s file: a page theme cover, badge or footer logo takes an image of at most 3 MB, an Open media step takes any media. When one refuses it, the replacement is refused with MEDIA_REPLACE_NOT_ALLOWED, whose message names each refusing use and why, and whose metadata lists them in refusals (a JSON array). Media used only by Open media steps may change kind, a PDF for an MP4 video for example. A QR code design keeps its own copy of its logo: it never refuses a replacement, keeps its current logo, and is detached from the media when the replacement completes.  A file another media item of the workspace holds is refused with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and existingFileName). Declaring the media\'s own file returns unchanged true and no upload_url: there is nothing to replace. Only the difference in size counts against the workspace\'s storage allowance.  Requires the `media:write` scope.
+     * @summary Start replacing a media file
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {MediaServiceCreateReplaceUploadBody} mediaServiceCreateReplaceUploadBody
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceCreateReplaceUploadRaw(requestParameters: MediaServiceCreateReplaceUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaReplaceUploadResponse>>;
+    /**
+     * Starts replacing the file of an existing media item with a new one uploaded straight to storage. The media keeps its id, so everything using it follows: Open media steps hand out the new file and page themes show it as their background cover, badge or footer logo from the next visit. Declare the new file\'s name, MIME type and exact size in bytes, and optionally its sha256. Then PUT its bytes to upload_url with the upload_headers before upload_expires_at, and call CompleteReplace with the replacement_id. Until then the media is unchanged; a replacement not completed within an hour is discarded.  The new file must be acceptable to every use rendered from the media\'s file: a page theme cover, badge or footer logo takes an image of at most 3 MB, an Open media step takes any media. When one refuses it, the replacement is refused with MEDIA_REPLACE_NOT_ALLOWED, whose message names each refusing use and why, and whose metadata lists them in refusals (a JSON array). Media used only by Open media steps may change kind, a PDF for an MP4 video for example. A QR code design keeps its own copy of its logo: it never refuses a replacement, keeps its current logo, and is detached from the media when the replacement completes.  A file another media item of the workspace holds is refused with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and existingFileName). Declaring the media\'s own file returns unchanged true and no upload_url: there is nothing to replace. Only the difference in size counts against the workspace\'s storage allowance.  Requires the `media:write` scope.
+     * Start replacing a media file
+     */
+    mediaServiceCreateReplaceUpload(requestParameters: MediaServiceCreateReplaceUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaReplaceUploadResponse>;
     /**
      * Creates request options for mediaServiceCreateUpload without sending the request
      * @param {CreateMediaUploadRequest} createMediaUploadRequest
@@ -106,7 +174,7 @@ export interface MediaApiInterface {
      */
     mediaServiceCreateUploadRequestOpts(requestParameters: MediaServiceCreateUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  Requires the `media:write` scope.
+     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  A workspace holds each file once. Optionally declare sha256, the file\'s SHA-256 as hex: a file the workspace already holds is then refused here, before any upload, with 409 MEDIA_ALREADY_EXISTS, whose metadata names that media in existingMediaId and existingFileName (use it instead), and storage refuses bytes that do not match the hash, so the PUT must send the x-amz-checksum-sha256 header from upload_headers. Without sha256 the duplicate is caught on completion instead.  Requires the `media:write` scope.
      * @summary Start a direct media upload
      * @param {CreateMediaUploadRequest} createMediaUploadRequest
      * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
@@ -116,7 +184,7 @@ export interface MediaApiInterface {
      */
     mediaServiceCreateUploadRaw(requestParameters: MediaServiceCreateUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaUploadResponse>>;
     /**
-     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  Requires the `media:write` scope.
+     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  A workspace holds each file once. Optionally declare sha256, the file\'s SHA-256 as hex: a file the workspace already holds is then refused here, before any upload, with 409 MEDIA_ALREADY_EXISTS, whose metadata names that media in existingMediaId and existingFileName (use it instead), and storage refuses bytes that do not match the hash, so the PUT must send the x-amz-checksum-sha256 header from upload_headers. Without sha256 the duplicate is caught on completion instead.  Requires the `media:write` scope.
      * Start a direct media upload
      */
     mediaServiceCreateUpload(requestParameters: MediaServiceCreateUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaUploadResponse>;
@@ -128,7 +196,7 @@ export interface MediaApiInterface {
      */
     mediaServiceDeleteRequestOpts(requestParameters: MediaServiceDeleteRequest): Promise<runtime.RequestOpts>;
     /**
-     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step is refused with MEDIA_IN_USE, naming the links that use it: point those steps at other media first. Deleting an image a page theme or a QR code design uses is allowed: the page theme loses the image, and a QR code keeps its own copy of the logo.  Requires the `media:write` scope.
+     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step, or shown by a page theme as its background cover, badge or footer logo (of a link or of a page theme template), is refused with MEDIA_IN_USE, naming what uses it (metadata linkIds and pageThemeTemplateIds): point those at other media or remove it from them first. Deleting an image a QR code design uses as its logo is allowed: the QR code keeps its own copy of the logo, and its link to the media is cleared.  Requires the `media:write` scope.
      * @summary Delete a media file
      * @param {string} id The ID of the media file to delete (UUID)
      * @param {*} [options] Override http request option.
@@ -137,7 +205,7 @@ export interface MediaApiInterface {
      */
     mediaServiceDeleteRaw(requestParameters: MediaServiceDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
     /**
-     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step is refused with MEDIA_IN_USE, naming the links that use it: point those steps at other media first. Deleting an image a page theme or a QR code design uses is allowed: the page theme loses the image, and a QR code keeps its own copy of the logo.  Requires the `media:write` scope.
+     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step, or shown by a page theme as its background cover, badge or footer logo (of a link or of a page theme template), is refused with MEDIA_IN_USE, naming what uses it (metadata linkIds and pageThemeTemplateIds): point those at other media or remove it from them first. Deleting an image a QR code design uses as its logo is allowed: the QR code keeps its own copy of the logo, and its link to the media is cleared.  Requires the `media:write` scope.
      * Delete a media file
      */
     mediaServiceDelete(requestParameters: MediaServiceDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
@@ -171,7 +239,7 @@ export interface MediaApiInterface {
      */
     mediaServiceImportRequestOpts(requestParameters: MediaServiceImportRequest): Promise<runtime.RequestOpts>;
     /**
-     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  Requires the `media:write` scope.
+     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * @summary Import a media file from a URL
      * @param {ImportMediaRequest} importMediaRequest
      * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
@@ -181,7 +249,7 @@ export interface MediaApiInterface {
      */
     mediaServiceImportRaw(requestParameters: MediaServiceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ImportMediaResponse>>;
     /**
-     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  Requires the `media:write` scope.
+     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Import a media file from a URL
      */
     mediaServiceImport(requestParameters: MediaServiceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ImportMediaResponse>;
@@ -216,22 +284,61 @@ export interface MediaApiInterface {
      * List media files
      */
     mediaServiceList(requestParameters: MediaServiceListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMediaResponse>;
+    /**
+     * Creates request options for mediaServiceReplaceImport without sending the request
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {MediaServiceReplaceImportBody} mediaServiceReplaceImportBody
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceReplaceImportRequestOpts(requestParameters: MediaServiceReplaceImportRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Replaces the file of an existing media item with one fetched server-side, from a public https url or a file the caller attached to their own Assistant conversation, in one call. The same checks as CompleteReplace apply, with the same limits and URL rules as Import: every use rendered from the media must accept the new file (MEDIA_REPLACE_NOT_ALLOWED lists each refusing use and why), a file another media item holds is refused with MEDIA_ALREADY_EXISTS, and only the size difference counts against the storage allowance. The media keeps its id; QR code designs using it as a logo keep their current logo and are detached from it. A file identical to the media\'s own returns unchanged true.  Requires the `media:write` scope.
+     * @summary Replace a media file from a URL
+     * @param {string} id The ID of the media item whose file is replaced (UUID)
+     * @param {MediaServiceReplaceImportBody} mediaServiceReplaceImportBody
+     * @param {string} [idempotencyKey] Makes retrying this request safe. See components.parameters.IdempotencyKey.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof MediaApiInterface
+     */
+    mediaServiceReplaceImportRaw(requestParameters: MediaServiceReplaceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ReplaceMediaImportResponse>>;
+    /**
+     * Replaces the file of an existing media item with one fetched server-side, from a public https url or a file the caller attached to their own Assistant conversation, in one call. The same checks as CompleteReplace apply, with the same limits and URL rules as Import: every use rendered from the media must accept the new file (MEDIA_REPLACE_NOT_ALLOWED lists each refusing use and why), a file another media item holds is refused with MEDIA_ALREADY_EXISTS, and only the size difference counts against the storage allowance. The media keeps its id; QR code designs using it as a logo keep their current logo and are detached from it. A file identical to the media\'s own returns unchanged true.  Requires the `media:write` scope.
+     * Replace a media file from a URL
+     */
+    mediaServiceReplaceImport(requestParameters: MediaServiceReplaceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ReplaceMediaImportResponse>;
 }
 /**
  *
  */
 export declare class MediaApi extends runtime.BaseAPI implements MediaApiInterface {
+    /**
+     * Creates request options for mediaServiceCompleteReplace without sending the request
+     */
+    mediaServiceCompleteReplaceRequestOpts(requestParameters: MediaServiceCompleteReplaceRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Checks the new file PUT to the replacement\'s upload_url like CompleteUpload does (its size, its real format read from its first bytes, its SHA-256 established by the server), checks again that every use rendered from the media accepts it and that it fits the storage allowance, then swaps it in. The media keeps its id and takes the new file\'s name, MIME type, kind, size and sha256; its old file is deleted. QR code designs that used the media as their logo keep their current logo and are detached from it; they are returned in detached_references. On any refusal the new file is discarded and the media keeps its current file. A new file identical to the media\'s own changes nothing and returns unchanged true.  Requires the `media:write` scope.
+     * Complete replacing a media file
+     */
+    mediaServiceCompleteReplaceRaw(requestParameters: MediaServiceCompleteReplaceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompleteMediaReplaceResponse>>;
+    /**
+     * Checks the new file PUT to the replacement\'s upload_url like CompleteUpload does (its size, its real format read from its first bytes, its SHA-256 established by the server), checks again that every use rendered from the media accepts it and that it fits the storage allowance, then swaps it in. The media keeps its id and takes the new file\'s name, MIME type, kind, size and sha256; its old file is deleted. QR code designs that used the media as their logo keep their current logo and are detached from it; they are returned in detached_references. On any refusal the new file is discarded and the media keeps its current file. A new file identical to the media\'s own changes nothing and returns unchanged true.  Requires the `media:write` scope.
+     * Complete replacing a media file
+     */
+    mediaServiceCompleteReplace(requestParameters: MediaServiceCompleteReplaceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompleteMediaReplaceResponse>;
     /**
      * Creates request options for mediaServiceCompleteUpload without sending the request
      */
     mediaServiceCompleteUploadRequestOpts(requestParameters: MediaServiceCompleteUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  Requires the `media:write` scope.
+     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  The server always establishes the file\'s SHA-256 itself, from the checksum storage verified or by reading the file back. A file the workspace already holds is discarded with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names the existing media in existingMediaId and existingFileName. Use that media instead.  Requires the `media:write` scope.
      * Complete a direct media upload
      */
     mediaServiceCompleteUploadRaw(requestParameters: MediaServiceCompleteUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompleteMediaUploadResponse>>;
     /**
-     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  Requires the `media:write` scope.
+     * Checks the file PUT to the upload_url: its size, its real format read from its first bytes, and the storage allowance. When it matches what CreateUpload declared, the media becomes READY and is returned with a signed URL. When it does not, the file and the media are discarded and the error says why; start a new upload. Completing a media item that is already READY returns it.  The server always establishes the file\'s SHA-256 itself, from the checksum storage verified or by reading the file back. A file the workspace already holds is discarded with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names the existing media in existingMediaId and existingFileName. Use that media instead.  Requires the `media:write` scope.
      * Complete a direct media upload
      */
     mediaServiceCompleteUpload(requestParameters: MediaServiceCompleteUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompleteMediaUploadResponse>;
@@ -240,26 +347,40 @@ export declare class MediaApi extends runtime.BaseAPI implements MediaApiInterfa
      */
     mediaServiceCreateRequestOpts(requestParameters: MediaServiceCreateRequest): Promise<runtime.RequestOpts>;
     /**
-     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  Requires the `media:write` scope.
+     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Upload a media file
      */
     mediaServiceCreateRaw(requestParameters: MediaServiceCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaResponse>>;
     /**
-     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  Requires the `media:write` scope.
+     * Uploads a file sent in the request itself, base64 encoded over HTTP, up to 3 MB. Larger files (a PDF brochure, a video) are uploaded straight to storage instead: CreateUpload, a PUT of the file to the returned upload_url, then CompleteUpload. A media item only has a kind, read from its bytes: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB. Nothing about where it will be used is needed at upload: any image can then be a QR code logo, a background cover, a badge or a footer logo (up to 3 MB for those), and any media can be opened by an Open media step.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Upload a media file
      */
     mediaServiceCreate(requestParameters: MediaServiceCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaResponse>;
+    /**
+     * Creates request options for mediaServiceCreateReplaceUpload without sending the request
+     */
+    mediaServiceCreateReplaceUploadRequestOpts(requestParameters: MediaServiceCreateReplaceUploadRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Starts replacing the file of an existing media item with a new one uploaded straight to storage. The media keeps its id, so everything using it follows: Open media steps hand out the new file and page themes show it as their background cover, badge or footer logo from the next visit. Declare the new file\'s name, MIME type and exact size in bytes, and optionally its sha256. Then PUT its bytes to upload_url with the upload_headers before upload_expires_at, and call CompleteReplace with the replacement_id. Until then the media is unchanged; a replacement not completed within an hour is discarded.  The new file must be acceptable to every use rendered from the media\'s file: a page theme cover, badge or footer logo takes an image of at most 3 MB, an Open media step takes any media. When one refuses it, the replacement is refused with MEDIA_REPLACE_NOT_ALLOWED, whose message names each refusing use and why, and whose metadata lists them in refusals (a JSON array). Media used only by Open media steps may change kind, a PDF for an MP4 video for example. A QR code design keeps its own copy of its logo: it never refuses a replacement, keeps its current logo, and is detached from the media when the replacement completes.  A file another media item of the workspace holds is refused with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and existingFileName). Declaring the media\'s own file returns unchanged true and no upload_url: there is nothing to replace. Only the difference in size counts against the workspace\'s storage allowance.  Requires the `media:write` scope.
+     * Start replacing a media file
+     */
+    mediaServiceCreateReplaceUploadRaw(requestParameters: MediaServiceCreateReplaceUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaReplaceUploadResponse>>;
+    /**
+     * Starts replacing the file of an existing media item with a new one uploaded straight to storage. The media keeps its id, so everything using it follows: Open media steps hand out the new file and page themes show it as their background cover, badge or footer logo from the next visit. Declare the new file\'s name, MIME type and exact size in bytes, and optionally its sha256. Then PUT its bytes to upload_url with the upload_headers before upload_expires_at, and call CompleteReplace with the replacement_id. Until then the media is unchanged; a replacement not completed within an hour is discarded.  The new file must be acceptable to every use rendered from the media\'s file: a page theme cover, badge or footer logo takes an image of at most 3 MB, an Open media step takes any media. When one refuses it, the replacement is refused with MEDIA_REPLACE_NOT_ALLOWED, whose message names each refusing use and why, and whose metadata lists them in refusals (a JSON array). Media used only by Open media steps may change kind, a PDF for an MP4 video for example. A QR code design keeps its own copy of its logo: it never refuses a replacement, keeps its current logo, and is detached from the media when the replacement completes.  A file another media item of the workspace holds is refused with 409 MEDIA_ALREADY_EXISTS (metadata existingMediaId and existingFileName). Declaring the media\'s own file returns unchanged true and no upload_url: there is nothing to replace. Only the difference in size counts against the workspace\'s storage allowance.  Requires the `media:write` scope.
+     * Start replacing a media file
+     */
+    mediaServiceCreateReplaceUpload(requestParameters: MediaServiceCreateReplaceUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaReplaceUploadResponse>;
     /**
      * Creates request options for mediaServiceCreateUpload without sending the request
      */
     mediaServiceCreateUploadRequestOpts(requestParameters: MediaServiceCreateUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  Requires the `media:write` scope.
+     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  A workspace holds each file once. Optionally declare sha256, the file\'s SHA-256 as hex: a file the workspace already holds is then refused here, before any upload, with 409 MEDIA_ALREADY_EXISTS, whose metadata names that media in existingMediaId and existingFileName (use it instead), and storage refuses bytes that do not match the hash, so the PUT must send the x-amz-checksum-sha256 header from upload_headers. Without sha256 the duplicate is caught on completion instead.  Requires the `media:write` scope.
      * Start a direct media upload
      */
     mediaServiceCreateUploadRaw(requestParameters: MediaServiceCreateUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateMediaUploadResponse>>;
     /**
-     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  Requires the `media:write` scope.
+     * Reserves a media item for a file uploaded straight to storage, so large files never pass through the API. Declare the file\'s name, MIME type and exact size in bytes; they are checked against the limit for the file\'s kind (images up to 10 MB, PDF documents up to 25 MB, MP4 videos up to 50 MB) and against the workspace\'s storage allowance now, and against the uploaded bytes on completion. Then PUT the file\'s bytes to upload_url with the upload_headers (and a Content-Length equal to size) before upload_expires_at, and call CompleteUpload. Until completed the media is PENDING: it is not listed and cannot be used. An upload not completed within an hour is discarded.  A workspace holds each file once. Optionally declare sha256, the file\'s SHA-256 as hex: a file the workspace already holds is then refused here, before any upload, with 409 MEDIA_ALREADY_EXISTS, whose metadata names that media in existingMediaId and existingFileName (use it instead), and storage refuses bytes that do not match the hash, so the PUT must send the x-amz-checksum-sha256 header from upload_headers. Without sha256 the duplicate is caught on completion instead.  Requires the `media:write` scope.
      * Start a direct media upload
      */
     mediaServiceCreateUpload(requestParameters: MediaServiceCreateUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateMediaUploadResponse>;
@@ -268,12 +389,12 @@ export declare class MediaApi extends runtime.BaseAPI implements MediaApiInterfa
      */
     mediaServiceDeleteRequestOpts(requestParameters: MediaServiceDeleteRequest): Promise<runtime.RequestOpts>;
     /**
-     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step is refused with MEDIA_IN_USE, naming the links that use it: point those steps at other media first. Deleting an image a page theme or a QR code design uses is allowed: the page theme loses the image, and a QR code keeps its own copy of the logo.  Requires the `media:write` scope.
+     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step, or shown by a page theme as its background cover, badge or footer logo (of a link or of a page theme template), is refused with MEDIA_IN_USE, naming what uses it (metadata linkIds and pageThemeTemplateIds): point those at other media or remove it from them first. Deleting an image a QR code design uses as its logo is allowed: the QR code keeps its own copy of the logo, and its link to the media is cleared.  Requires the `media:write` scope.
      * Delete a media file
      */
     mediaServiceDeleteRaw(requestParameters: MediaServiceDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
     /**
-     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step is refused with MEDIA_IN_USE, naming the links that use it: point those steps at other media first. Deleting an image a page theme or a QR code design uses is allowed: the page theme loses the image, and a QR code keeps its own copy of the logo.  Requires the `media:write` scope.
+     * Removes a media file from the workspace and frees its storage. This operation cannot be undone. Media still opened by an Open media step, or shown by a page theme as its background cover, badge or footer logo (of a link or of a page theme template), is refused with MEDIA_IN_USE, naming what uses it (metadata linkIds and pageThemeTemplateIds): point those at other media or remove it from them first. Deleting an image a QR code design uses as its logo is allowed: the QR code keeps its own copy of the logo, and its link to the media is cleared.  Requires the `media:write` scope.
      * Delete a media file
      */
     mediaServiceDelete(requestParameters: MediaServiceDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
@@ -296,12 +417,12 @@ export declare class MediaApi extends runtime.BaseAPI implements MediaApiInterfa
      */
     mediaServiceImportRequestOpts(requestParameters: MediaServiceImportRequest): Promise<runtime.RequestOpts>;
     /**
-     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  Requires the `media:write` scope.
+     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Import a media file from a URL
      */
     mediaServiceImportRaw(requestParameters: MediaServiceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ImportMediaResponse>>;
     /**
-     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  Requires the `media:write` scope.
+     * Fetches a file server-side and stores it as a READY media item, so a file that is already online, or one attached to an Assistant conversation, never has to be downloaded and uploaded again. Give exactly one source: url, a public https address the file is downloaded from, or assistant_attachment_id, a file the caller attached to their own Assistant conversation. The kind is read from the file\'s bytes, never from its name or a Content-Type header, and the same limits as every upload apply: images (PNG, JPEG, WebP, SVG) up to 10 MB, PDF documents up to 25 MB and MP4 videos up to 50 MB, within the workspace\'s media storage allowance. A URL must be https on port 443 and resolve to a public address; redirects are followed only to other such URLs, at most five.  A workspace holds each file once. A file whose bytes (SHA-256) match media the workspace already has is refused with 409 MEDIA_ALREADY_EXISTS; the error\'s metadata names that media in existingMediaId and existingFileName. Use that media instead of uploading the file again.  Requires the `media:write` scope.
      * Import a media file from a URL
      */
     mediaServiceImport(requestParameters: MediaServiceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ImportMediaResponse>;
@@ -319,4 +440,18 @@ export declare class MediaApi extends runtime.BaseAPI implements MediaApiInterfa
      * List media files
      */
     mediaServiceList(requestParameters: MediaServiceListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMediaResponse>;
+    /**
+     * Creates request options for mediaServiceReplaceImport without sending the request
+     */
+    mediaServiceReplaceImportRequestOpts(requestParameters: MediaServiceReplaceImportRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Replaces the file of an existing media item with one fetched server-side, from a public https url or a file the caller attached to their own Assistant conversation, in one call. The same checks as CompleteReplace apply, with the same limits and URL rules as Import: every use rendered from the media must accept the new file (MEDIA_REPLACE_NOT_ALLOWED lists each refusing use and why), a file another media item holds is refused with MEDIA_ALREADY_EXISTS, and only the size difference counts against the storage allowance. The media keeps its id; QR code designs using it as a logo keep their current logo and are detached from it. A file identical to the media\'s own returns unchanged true.  Requires the `media:write` scope.
+     * Replace a media file from a URL
+     */
+    mediaServiceReplaceImportRaw(requestParameters: MediaServiceReplaceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ReplaceMediaImportResponse>>;
+    /**
+     * Replaces the file of an existing media item with one fetched server-side, from a public https url or a file the caller attached to their own Assistant conversation, in one call. The same checks as CompleteReplace apply, with the same limits and URL rules as Import: every use rendered from the media must accept the new file (MEDIA_REPLACE_NOT_ALLOWED lists each refusing use and why), a file another media item holds is refused with MEDIA_ALREADY_EXISTS, and only the size difference counts against the storage allowance. The media keeps its id; QR code designs using it as a logo keep their current logo and are detached from it. A file identical to the media\'s own returns unchanged true.  Requires the `media:write` scope.
+     * Replace a media file from a URL
+     */
+    mediaServiceReplaceImport(requestParameters: MediaServiceReplaceImportRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ReplaceMediaImportResponse>;
 }