docs: Improve descriptions of types (box/box-openapi#527)

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "20cb559", "specHash": "2da99e0", "version": "1.15.1" }
+{ "engineHash": "20cb559", "specHash": "a54170e", "version": "1.15.1" }

src/managers/files.generated.ts

@@ -452,7 +452,10 @@ export interface UpdateFileByIdRequestBodyCollectionsField {
 export interface UpdateFileByIdRequestBody {
   /**
    * An optional different name for the file. This can be used to
-   * rename the file. */
+   * rename the file.
+   *
+   * File names must be unique within their parent folder. The name check is case-insensitive, so a file
+   * named `New File` cannot be created in a parent folder that already contains a folder named `new file`. */
   readonly name?: string;
   /**
    * The description for a file. This can be seen in the right-hand sidebar panel

src/managers/folders.generated.ts

@@ -469,7 +469,16 @@ export interface UpdateFolderByIdRequestBodyCollectionsField {
 }
 export interface UpdateFolderByIdRequestBody {
   /**
-   * The optional new name for this folder. */
+   * The optional new name for this folder.
+   *
+   * The following restrictions to folder names apply: names containing
+   * non-printable ASCII characters, forward and backward slashes
+   * (`/`, `\`), names with trailing spaces, and names `.` and `..` are
+   * not allowed.
+   *
+   * Folder names must be unique within their parent folder. The name check is case-insensitive,
+   * so a folder named `New Folder` cannot be created in a parent folder that already contains
+   * a folder named `new folder`. */
   readonly name?: string;
   /**
    * The optional description of this folder */
@@ -811,13 +820,14 @@ export interface CreateFolderRequestBody {
   /**
    * The name for the new folder.
    *
-   * There are some restrictions to the file name. Names containing
+   * The following restrictions to folder names apply: names containing
    * non-printable ASCII characters, forward and backward slashes
-   * (`/`, `\`), as well as names with trailing spaces are
-   * prohibited.
+   * (`/`, `\`), names with trailing spaces, and names `.` and `..` are
+   * not allowed.
    *
-   * Additionally, the names `.` and `..` are
-   * not allowed either. */
+   * Folder names must be unique within their parent folder. The name check is case-insensitive,
+   * so a folder named `New Folder` cannot be created in a parent folder that already contains
+   * a folder named `new folder`. */
   readonly name: string;
   /**
    * The parent folder to create the new folder within. */

src/managers/uploads.generated.ts

@@ -292,7 +292,10 @@ export interface UploadFileRequestBodyAttributesParentField {
 }
 export interface UploadFileRequestBodyAttributesField {
   /**
-   * The name of the file */
+   * The name of the file.
+   *
+   * File names must be unique within their parent folder. The name check is case-insensitive, so a file
+   * named `New File` cannot be created in a parent folder that already contains a folder named `new file`. */
   readonly name: string;
   /**
    * The parent folder to upload the file to */
@@ -396,7 +399,10 @@ export interface UploadWithPreflightCheckRequestBodyAttributesParentField {
 }
 export interface UploadWithPreflightCheckRequestBodyAttributesField {
   /**
-   * The name of the file */
+   * The name of the file.
+   *
+   * File names must be unique within their parent folder. The name check is case-insensitive, so a file
+   * named `New File` cannot be created in a parent folder that already contains a folder named `new file`. */
   readonly name: string;
   /**
    * The parent folder to upload the file to */