@hubspot/app-connect-sdk 1.0.0-alpha.1

package/src/server/api-client-core/apis/files-types.generated.ts

@@ -0,0 +1,904 @@
+// DO NOT MODIFY - This code was generated by @hubspot/api-client-next-generator
+
+import type { BinaryData } from '../binary-data.ts';
+import type { Operation } from '../types.ts';
+
+export namespace Files {
+  export namespace Files {
+    export type CreateInput = Schemas.FolderInput;
+
+    export type CreateOutput = Schemas.Folder;
+
+    export interface DeleteInput {
+      fileId: string;
+    }
+
+    export type DeleteOutput = void;
+
+    export interface GdprDeleteInput {
+      fileId: string;
+    }
+
+    export type GdprDeleteOutput = void;
+
+    export interface GetByPathInput {
+      path: string;
+      properties?: string[];
+    }
+
+    export type GetByPathOutput = Schemas.FileStat;
+
+    export interface GetImportTaskStatusInput {
+      taskId: string;
+    }
+
+    export type GetImportTaskStatusOutput = Schemas.FileActionResponse;
+
+    export interface GetInput {
+      fileId: string;
+      properties?: string[];
+    }
+
+    export type GetOutput = Schemas.File;
+
+    export interface GetSignedUrlInput {
+      expirationSeconds?: number;
+      fileId: string;
+      size?: 'icon' | 'medium' | 'preview' | 'thumb';
+      upscale?: boolean;
+    }
+
+    export type GetSignedUrlOutput = Schemas.SignedUrl;
+
+    export type ImportFromUrlAsyncInput = Schemas.ImportFromUrlInput;
+
+    export type ImportFromUrlAsyncOutput = Schemas.ImportFromUrlTaskLocator;
+
+    export interface ReplaceInput {
+      data?: {
+        charsetHunch?: string;
+        file?: BinaryData;
+        options?: Schemas.FileReplaceOptions;
+      };
+      fileId: string;
+    }
+
+    export type ReplaceOutput = Schemas.File;
+
+    export interface SearchInput {
+      /**
+       * The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results.
+       */
+      after?: string;
+      allowsAnonymousAccess?: boolean;
+      before?: string;
+      createdAt?: string;
+      createdAtGte?: string;
+      createdAtLte?: string;
+      encoding?: string;
+      expiresAt?: string;
+      expiresAtGte?: string;
+      expiresAtLte?: string;
+      extension?: string;
+      fileMd5?: string;
+      height?: number;
+      heightGte?: number;
+      heightLte?: number;
+      idGte?: number;
+      idLte?: number;
+      ids?: number[];
+      isUsableInContent?: boolean;
+      /**
+       * The maximum number of results to display per page.
+       */
+      limit?: number;
+      name?: string;
+      parentFolderIds?: number[];
+      path?: string;
+      properties?: string[];
+      size?: number;
+      sizeGte?: number;
+      sizeLte?: number;
+      sort?: string[];
+      type?: string;
+      updatedAt?: string;
+      updatedAtGte?: string;
+      updatedAtLte?: string;
+      url?: string;
+      width?: number;
+      widthGte?: number;
+      widthLte?: number;
+    }
+
+    export type SearchOutput = Schemas.CollectionResponseFile;
+
+    export interface UpdateInput {
+      data: Schemas.FileUpdateInput;
+      fileId: string;
+    }
+
+    export type UpdateOutput = Schemas.File;
+
+    export interface UploadInput {
+      charsetHunch?: string;
+      file?: BinaryData;
+      fileName?: string;
+      folderId?: string;
+      folderPath?: string;
+      options?: Schemas.FileUploadOptions;
+    }
+
+    export type UploadOutput = Schemas.File;
+  }
+
+  export namespace Folders {
+    export interface DeleteByIdInput {
+      folderId: string;
+    }
+
+    export type DeleteByIdOutput = void;
+
+    export interface DeleteByPathInput {
+      folderPath: string;
+    }
+
+    export type DeleteByPathOutput = void;
+
+    export interface GetByIdInput {
+      folderId: string;
+      properties?: string[];
+    }
+
+    export type GetByIdOutput = Schemas.Folder;
+
+    export interface GetByPathInput {
+      folderPath: string;
+      properties?: string[];
+    }
+
+    export type GetByPathOutput = Schemas.Folder;
+
+    export interface GetUpdateAsyncStatusInput {
+      taskId: string;
+    }
+
+    export type GetUpdateAsyncStatusOutput = Schemas.FolderActionResponse;
+
+    export interface SearchInput {
+      /**
+       * The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results.
+       */
+      after?: string;
+      before?: string;
+      createdAt?: string;
+      createdAtGte?: string;
+      createdAtLte?: string;
+      idGte?: number;
+      idLte?: number;
+      ids?: number[];
+      /**
+       * The maximum number of results to display per page.
+       */
+      limit?: number;
+      name?: string;
+      parentFolderIds?: number[];
+      path?: string;
+      properties?: string[];
+      sort?: string[];
+      updatedAt?: string;
+      updatedAtGte?: string;
+      updatedAtLte?: string;
+    }
+
+    export type SearchOutput = Schemas.CollectionResponseFolder;
+
+    export type UpdateAsyncByIdInput = Schemas.FolderUpdateInputWithId;
+
+    export type UpdateAsyncByIdOutput = Schemas.FolderUpdateTaskLocator;
+
+    export interface UpdateByIdInput {
+      data: Schemas.FolderUpdateInput;
+      folderId: string;
+    }
+
+    export type UpdateByIdOutput = Schemas.Folder;
+  }
+
+  export namespace Schemas {
+    export interface CollectionResponseFile {
+      paging?: Schemas.Paging;
+      results: Schemas.File[];
+    }
+
+    export interface CollectionResponseFolder {
+      paging?: Schemas.Paging;
+      results: Schemas.Folder[];
+    }
+
+    export interface ErrorDetail {
+      /**
+       * The status code associated with the error detail
+       */
+      code?: string;
+      /**
+       * Context about the error condition
+       */
+      context?: Record<string, string[]>;
+      /**
+       * The name of the field or parameter in which the error was found.
+       */
+      in?: string;
+      /**
+       * A human readable message describing the error along with remediation steps where appropriate
+       */
+      message: string;
+      /**
+       * A specific category that contains more specific detail about the error
+       */
+      subCategory?: string;
+    }
+
+    export interface File {
+      /**
+       * File access. Can be PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.
+       */
+      access?:
+        | 'HIDDEN_INDEXABLE'
+        | 'HIDDEN_NOT_INDEXABLE'
+        | 'HIDDEN_PRIVATE'
+        | 'HIDDEN_SENSITIVE'
+        | 'PRIVATE'
+        | 'PUBLIC_INDEXABLE'
+        | 'PUBLIC_NOT_INDEXABLE'
+        | 'SENSITIVE';
+      /**
+       * If the file is deleted.
+       */
+      archived: boolean;
+      /**
+       * Deletion time of the file object.
+       */
+      archivedAt?: string;
+      /**
+       * Creation time of the file object.
+       */
+      createdAt: string;
+      /**
+       * Default hosting URL of the file. This will use one of HubSpot's provided URLs to serve the file.
+       */
+      defaultHostingUrl?: string;
+      /**
+       * Encoding of the file.
+       */
+      encoding?: string;
+      expiresAt?: number;
+      /**
+       * Extension of the file. ex: .jpg, .png, .gif, .pdf, etc.
+       */
+      extension?: string;
+      /**
+       * The MD5 hash of the file.
+       */
+      fileMd5?: string;
+      /**
+       * For image and video files, the height of the content.
+       */
+      height?: number;
+      /**
+       * File ID.
+       */
+      id: string;
+      /**
+       * Previously "archied". Indicates if the file should be used when creating new content like web pages.
+       */
+      isUsableInContent?: boolean;
+      /**
+       * Name of the file.
+       */
+      name?: string;
+      /**
+       * ID of the folder the file is in.
+       */
+      parentFolderId?: string;
+      /**
+       * Path of the file in the file manager.
+       */
+      path?: string;
+      /**
+       * Size of the file in bytes.
+       */
+      size?: number;
+      sourceGroup?:
+        | 'CONTENT'
+        | 'CONVERSATIONS'
+        | 'FORMS'
+        | 'UI_EXTENSIONS'
+        | 'UNKNOWN';
+      /**
+       * Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.
+       */
+      type?: string;
+      /**
+       * Timestamp of the latest update to the file.
+       */
+      updatedAt: string;
+      /**
+       * URL of the given file. This URL can change depending on the domain settings of the account. Will use the select file hosting domain.
+       */
+      url?: string;
+      /**
+       * For image and video files, the width of the content.
+       */
+      width?: number;
+    }
+
+    export interface FileActionResponse {
+      /**
+       * Time of completion of task.
+       */
+      completedAt: string;
+      /**
+       * Descriptive error messages.
+       */
+      errors?: Schemas.StandardError[];
+      /**
+       * Link to check the status of the requested task.
+       */
+      links?: Record<string, string>;
+      /**
+       * Number of errors resulting from the task.
+       */
+      numErrors?: number;
+      /**
+       * Timestamp of when the task was requested.
+       */
+      requestedAt?: string;
+      result?: Schemas.File;
+      /**
+       * Timestamp of when the task was started.
+       */
+      startedAt: string;
+      /**
+       * Current status of the task.
+       */
+      status: 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING';
+      /**
+       * ID of the requested task.
+       */
+      taskId: string;
+    }
+
+    export interface FileReplaceOptions {
+      access?: string;
+      expiresAt?: number;
+    }
+
+    export interface FileStat {
+      file?: Schemas.File;
+      folder?: Schemas.Folder;
+    }
+
+    export interface FileUpdateInput {
+      /**
+       * NONE: Do not run any duplicate validation. REJECT: Reject the upload if a duplicate is found. RETURN_EXISTING: If a duplicate file is found, do not upload a new file and return the found duplicate instead.
+       */
+      access?:
+        | 'HIDDEN_INDEXABLE'
+        | 'HIDDEN_NOT_INDEXABLE'
+        | 'HIDDEN_PRIVATE'
+        | 'HIDDEN_SENSITIVE'
+        | 'PRIVATE'
+        | 'PUBLIC_INDEXABLE'
+        | 'PUBLIC_NOT_INDEXABLE'
+        | 'SENSITIVE';
+      clearExpires: boolean;
+      expiresAt?: string;
+      /**
+       * Mark whether the file should be used in new content or not.
+       */
+      isUsableInContent?: boolean;
+      /**
+       * New name for the file.
+       */
+      name?: string;
+      /**
+       * FolderId where the file should be moved to. folderId and folderPath parameters cannot be set at the same time.
+       */
+      parentFolderId?: string;
+      /**
+       * Folder path where the file should be moved to. folderId and folderPath parameters cannot be set at the same time.
+       */
+      parentFolderPath?: string;
+    }
+
+    export interface FileUploadOptions {
+      access: string;
+      ttl?: string;
+    }
+
+    export interface Folder {
+      /**
+       * Marks whether the folder is deleted or not.
+       */
+      archived: boolean;
+      /**
+       * Timestamp of folder deletion.
+       */
+      archivedAt?: string;
+      /**
+       * Timestamp of folder creation.
+       */
+      createdAt: string;
+      /**
+       * ID of the folder.
+       */
+      id: string;
+      /**
+       * Name of the folder.
+       */
+      name?: string;
+      /**
+       * ID of the parent folder.
+       */
+      parentFolderId?: string;
+      /**
+       * Path of the folder in the file manager.
+       */
+      path?: string;
+      /**
+       * Timestamp of the latest update to the folder.
+       */
+      updatedAt: string;
+    }
+
+    export interface FolderActionResponse {
+      /**
+       * When the requested changes have been completed.
+       */
+      completedAt: string;
+      /**
+       * Detailed errors resulting from the task.
+       */
+      errors?: Schemas.StandardError[];
+      /**
+       * Link to check the status of the task.
+       */
+      links?: Record<string, string>;
+      /**
+       * Number of errors resulting from the requested changes.
+       */
+      numErrors?: number;
+      /**
+       * Timestamp representing when the task was requested.
+       */
+      requestedAt?: string;
+      result?: Schemas.Folder;
+      /**
+       * Timestamp representing when the task was started at.
+       */
+      startedAt: string;
+      /**
+       * Current status of the task.
+       */
+      status: 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING';
+      /**
+       * ID of the task.
+       */
+      taskId: string;
+    }
+
+    export interface FolderInput {
+      /**
+       * Desired name for the folder.
+       */
+      name: string;
+      /**
+       * FolderId of the parent of the created folder. If not specified, the folder will be created at the root level. parentFolderId and parentFolderPath cannot be set at the same time.
+       */
+      parentFolderId?: string;
+      /**
+       * Path of the parent of the created folder. If not specified the folder will be created at the root level. parentFolderPath and parentFolderId cannot be set at the same time.
+       */
+      parentPath?: string;
+    }
+
+    export interface FolderUpdateInput {
+      /**
+       * New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.
+       */
+      name?: string;
+      /**
+       * New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.
+       */
+      parentFolderId?: number;
+    }
+
+    export interface FolderUpdateInputWithId {
+      /**
+       * The unique identifier of the folder to be updated.
+       */
+      id: string;
+      /**
+       * New name. If specified the folder's name and fullPath will change. All children of the folder will be updated accordingly.
+       */
+      name?: string;
+      /**
+       * New parent folderId. If changed, the folder and all it's children will be moved into the specified folder. parentFolderId and parentFolderPath cannot be specified at the same time.
+       */
+      parentFolderId?: number;
+    }
+
+    export interface FolderUpdateTaskLocator {
+      /**
+       * ID of the task
+       */
+      id: string;
+      /**
+       * Links for where to check information related to the task. The `status` link gives the URL for where to check the status of the task.
+       */
+      links?: Record<string, string>;
+    }
+
+    export interface ImportFromUrlInput {
+      /**
+       * PUBLIC_INDEXABLE: File is publicly accessible by anyone who has the URL. Search engines can index the file. PUBLIC_NOT_INDEXABLE: File is publicly accessible by anyone who has the URL. Search engines *can't* index the file. PRIVATE: File is NOT publicly accessible. Requires a signed URL to see content. Search engines *can't* index the file.
+       */
+      access:
+        | 'HIDDEN_INDEXABLE'
+        | 'HIDDEN_NOT_INDEXABLE'
+        | 'HIDDEN_PRIVATE'
+        | 'HIDDEN_SENSITIVE'
+        | 'PRIVATE'
+        | 'PUBLIC_INDEXABLE'
+        | 'PUBLIC_NOT_INDEXABLE'
+        | 'SENSITIVE';
+      /**
+       * ENTIRE_PORTAL: Look for a duplicate file in the entire account. EXACT_FOLDER: Look for a duplicate file in the provided folder.
+       */
+      duplicateValidationScope: 'ENTIRE_PORTAL' | 'EXACT_FOLDER';
+      /**
+       * NONE: Do not run any duplicate validation. REJECT: Reject the upload if a duplicate is found. RETURN_EXISTING: If a duplicate file is found, do not upload a new file and return the found duplicate instead.
+       */
+      duplicateValidationStrategy: 'NONE' | 'REJECT' | 'RETURN_EXISTING';
+      /**
+       * Specifies the date and time when the file will expire.
+       */
+      expiresAt?: string;
+      /**
+       * One of folderId or folderPath is required. Destination folderId for the uploaded file.
+       */
+      folderId?: string;
+      /**
+       * One of folderPath or folderId is required. Destination folder path for the uploaded file. If the folder path does not exist, there will be an attempt to create the folder path.
+       */
+      folderPath?: string;
+      /**
+       * Name to give the resulting file in the file manager.
+       */
+      name?: string;
+      /**
+       * If true, will overwrite existing file if one with the same name and extension exists in the given folder. The overwritten file will be deleted and the uploaded file will take its place with a new ID. If unset or set as false, the new file's name will be updated to prevent colliding with existing file if one exists with the same path, name, and extension
+       */
+      overwrite: boolean;
+      /**
+       * Time to live. If specified the file will be deleted after the given time frame. If left unset, the file will exist indefinitely
+       */
+      ttl?: string;
+      /**
+       * URL to download the new file from.
+       */
+      url?: string;
+    }
+
+    export interface ImportFromUrlTaskLocator {
+      /**
+       * ID of the task
+       */
+      id: string;
+      /**
+       * Links for where to check information related to the task. The `status` link gives the URL for where to check the status of the task.
+       */
+      links?: Record<string, string>;
+    }
+
+    /**
+     * Specifies the paging information needed to retrieve the next set of results in a paginated API response
+     */
+    export interface NextPage {
+      /**
+       * A paging cursor token for retrieving subsequent pages.
+       */
+      after: string;
+      /**
+       * A URL that can be used to retrieve the next page results.
+       */
+      link?: string;
+    }
+
+    export interface Paging {
+      next?: Schemas.NextPage;
+      prev?: Schemas.PreviousPage;
+    }
+
+    /**
+     * specifies the paging information needed to retrieve the previous set of results in a paginated API response
+     */
+    export interface PreviousPage {
+      /**
+       * A paging cursor token for retrieving previous pages.
+       */
+      before: string;
+      /**
+       * A URL that can be used to retrieve the previous pages' results.
+       */
+      link?: string;
+    }
+
+    export interface SignedUrl {
+      /**
+       * Timestamp of when the URL will no longer grant access to the file.
+       */
+      expiresAt: string;
+      /**
+       * Extension of the requested file.
+       */
+      extension?: string;
+      /**
+       * For image and video files. The height of the file.
+       */
+      height?: number;
+      /**
+       * Name of the requested file.
+       */
+      name?: string;
+      /**
+       * Size in bytes of the requested file.
+       */
+      size?: number;
+      /**
+       * Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.
+       */
+      type?: string;
+      /**
+       * Signed URL with access to the specified file. Anyone with this URL will be able to access the file until it expires.
+       */
+      url: string;
+      /**
+       * For image and video files. The width of the file.
+       */
+      width?: number;
+    }
+
+    /**
+     * Ye olde error
+     */
+    export interface StandardError {
+      /**
+       * The main category of the error.
+       */
+      category: string;
+      /**
+       * Additional context-specific information related to the error.
+       */
+      context: Record<string, string[]>;
+      /**
+       * The detailed error objects.
+       */
+      errors: Schemas.ErrorDetail[];
+      /**
+       * A unique ID for the error instance.
+       */
+      id?: string;
+      /**
+       * URLs linking to documentation or resources associated with the error.
+       */
+      links: Record<string, string>;
+      /**
+       * A human-readable string describing the error and possible remediation steps.
+       */
+      message: string;
+      /**
+       * The HTTP status code associated with the error.
+       */
+      status: string;
+      /**
+       * A more specific error category within each main category.
+       */
+      subCategory?: Record<string, never>;
+    }
+  }
+
+  /**
+   * Usage example:
+   * ```ts
+   * import { files } from '@hubspot/api-client-core';
+   * client.send(files.files.create(input));
+   * ```
+   */
+  export interface FilesAPI {
+    /**
+     * Create folder
+     * @apiPath /files/2026-03/folders
+     * @apiMethod POST
+     * @requiredScopes file-manager-write
+     */
+    create: (input: Files.CreateInput) => Operation<Files.CreateOutput>;
+    /**
+     * Delete file by ID
+     * @apiPath /files/2026-03/files/{fileId}
+     * @apiMethod DELETE
+     * @requiredScopes file-manager-delete
+     */
+    delete: (input: Files.DeleteInput) => Operation<Files.DeleteOutput>;
+    /**
+     * GDPR-delete file
+     * @apiPath /files/2026-03/files/{fileId}/gdpr-delete
+     * @apiMethod DELETE
+     * @requiredScopes file-manager-delete
+     */
+    gdprDelete: (
+      input: Files.GdprDeleteInput
+    ) => Operation<Files.GdprDeleteOutput>;
+    /**
+     * Retrieve file by ID
+     * @apiPath /files/2026-03/files/{fileId}
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    get: (input: Files.GetInput) => Operation<Files.GetOutput>;
+    /**
+     * Retrieve file by path
+     * @apiPath /files/2026-03/files/stat/{path}
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    getByPath: (
+      input: Files.GetByPathInput
+    ) => Operation<Files.GetByPathOutput>;
+    /**
+     * Check import status
+     * @apiPath /files/2026-03/files/import-from-url/async/tasks/{taskId}/status
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    getImportTaskStatus: (
+      input: Files.GetImportTaskStatusInput
+    ) => Operation<Files.GetImportTaskStatusOutput>;
+    /**
+     * Get signed URL to access private file
+     * @apiPath /files/2026-03/files/{fileId}/signed-url
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    getSignedUrl: (
+      input: Files.GetSignedUrlInput
+    ) => Operation<Files.GetSignedUrlOutput>;
+    /**
+     * Import file from URL
+     * @apiPath /files/2026-03/files/import-from-url/async
+     * @apiMethod POST
+     * @requiredScopes file-manager-write
+     */
+    importFromUrlAsync: (
+      input: Files.ImportFromUrlAsyncInput
+    ) => Operation<Files.ImportFromUrlAsyncOutput>;
+    /**
+     * Replace file
+     * @apiPath /files/2026-03/files/{fileId}
+     * @apiMethod PUT
+     * @requiredScopes file-manager-write
+     */
+    replace: (input: Files.ReplaceInput) => Operation<Files.ReplaceOutput>;
+    /**
+     * Search files
+     * @apiPath /files/2026-03/files/search
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    search: (input?: Files.SearchInput) => Operation<Files.SearchOutput>;
+    /**
+     * Update file properties
+     * @apiPath /files/2026-03/files/{fileId}
+     * @apiMethod PATCH
+     * @requiredScopes file-manager-write
+     */
+    update: (input: Files.UpdateInput) => Operation<Files.UpdateOutput>;
+    /**
+     * Upload file
+     * @apiPath /files/2026-03/files
+     * @apiMethod POST
+     * @requiredScopes file-manager-write
+     */
+    upload: (input?: Files.UploadInput) => Operation<Files.UploadOutput>;
+  }
+
+  /**
+   * Usage example:
+   * ```ts
+   * import { files } from '@hubspot/api-client-core';
+   * client.send(files.folders.deleteById(input));
+   * ```
+   */
+  export interface FoldersAPI {
+    /**
+     * Delete folder by ID
+     * @apiPath /files/2026-03/folders/{folderId}
+     * @apiMethod DELETE
+     * @requiredScopes file-manager-delete
+     */
+    deleteById: (
+      input: Folders.DeleteByIdInput
+    ) => Operation<Folders.DeleteByIdOutput>;
+    /**
+     * Delete folder by path
+     * @apiPath /files/2026-03/folders/{folderPath}
+     * @apiMethod DELETE
+     * @requiredScopes file-manager-delete
+     */
+    deleteByPath: (
+      input: Folders.DeleteByPathInput
+    ) => Operation<Folders.DeleteByPathOutput>;
+    /**
+     * Retrieve folder by ID
+     * @apiPath /files/2026-03/folders/{folderId}
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    getById: (input: Folders.GetByIdInput) => Operation<Folders.GetByIdOutput>;
+    /**
+     * Retrieve folder by path
+     * @apiPath /files/2026-03/folders/{folderPath}
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    getByPath: (
+      input: Folders.GetByPathInput
+    ) => Operation<Folders.GetByPathOutput>;
+    /**
+     * Check folder update status
+     * @apiPath /files/2026-03/folders/update/async/tasks/{taskId}/status
+     * @apiMethod GET
+     * @requiredScopes file-manager-write
+     */
+    getUpdateAsyncStatus: (
+      input: Folders.GetUpdateAsyncStatusInput
+    ) => Operation<Folders.GetUpdateAsyncStatusOutput>;
+    /**
+     * Search folders
+     * @apiPath /files/2026-03/folders/search
+     * @apiMethod GET
+     * @requiredScopes file-manager-access
+     */
+    search: (input?: Folders.SearchInput) => Operation<Folders.SearchOutput>;
+    /**
+     * Update folder properties
+     * @apiPath /files/2026-03/folders/update/async
+     * @apiMethod POST
+     * @requiredScopes file-manager-write
+     */
+    updateAsyncById: (
+      input: Folders.UpdateAsyncByIdInput
+    ) => Operation<Folders.UpdateAsyncByIdOutput>;
+    /**
+     * Update folder properties by folder ID
+     * @apiPath /files/2026-03/folders/{folderId}
+     * @apiMethod PATCH
+     * @requiredScopes file-manager-write
+     */
+    updateById: (
+      input: Folders.UpdateByIdInput
+    ) => Operation<Folders.UpdateByIdOutput>;
+  }
+
+  /**
+   * Usage example:
+   * ```ts
+   * import { files } from '@hubspot/api-client-core';
+   * client.send(files.files.create(input));
+   * ```
+   */
+  export interface API {
+    files: FilesAPI;
+    folders: FoldersAPI;
+  }
+}