@pnp/cli-microsoft365 11.4.0-beta.87732f5 → 11.4.0-beta.f54089d

package/dist/utils/spo.js

@@ -11,6 +11,7 @@ import { RoleType } from '../m365/spo/commands/roledefinition/RoleType.js';
 import { entraGroup } from './entraGroup.js';
 import { SharingCapabilities } from '../m365/spo/commands/site/SharingCapabilities.js';
 import { timersUtil } from './timersUtil.js';
+import { DOMParser } from '@xmldom/xmldom';
 export var CreateFileCopyJobsNameConflictBehavior;
 (function (CreateFileCopyJobsNameConflictBehavior) {
     CreateFileCopyJobsNameConflictBehavior[CreateFileCopyJobsNameConflictBehavior["Fail"] = 0] = "Fail";
@@ -1306,9 +1307,8 @@ export const spo = {
         if (response.indexOf("ErrorMessage") > -1) {
             throw `Error occurred in systemUpdate operation - ${response}`;
         }
-        const id = Number(itemId);
         const requestOptionsItems = {
-            url: `${absoluteListUrl}/items(${id})`,
+            url: `${absoluteListUrl}/items(${itemId})`,
             headers: {
                 'accept': 'application/json;odata=nometadata'
             },
@@ -1847,6 +1847,34 @@ export const spo = {
         roleDefinition.BasePermissionsValue = permissions.parse();
         roleDefinition.RoleTypeKindValue = RoleType[roleDefinition.RoleTypeKind];
         return roleDefinition;
+    },
+    /**
+     * Converts SharePoint default column values XML to a structured JSON array.
+     * Parses the XML content from client_LocationBasedDefaults.html file and extracts
+     * default field values configured for folders in a SharePoint document library.
+     *
+     * @param xml The XML string containing default column value definitions
+     * @returns An array of default column values with field names, values, and associated folder URLs
+     */
+    convertDefaultColumnXmlToJson(xml) {
+        const results = [];
+        const parser = new DOMParser();
+        const doc = parser.parseFromString(xml, 'application/xml');
+        const folderLinks = doc.getElementsByTagName('a');
+        for (let i = 0; i < folderLinks.length; i++) {
+            const folderUrl = folderLinks[i].getAttribute('href');
+            const defaultValues = folderLinks[i].getElementsByTagName('DefaultValue');
+            for (let j = 0; j < defaultValues.length; j++) {
+                const fieldName = defaultValues[j].getAttribute('FieldName');
+                const fieldValue = defaultValues[j].textContent;
+                results.push({
+                    fieldName: fieldName,
+                    fieldValue: fieldValue,
+                    folderUrl: decodeURIComponent(folderUrl)
+                });
+            }
+        }
+        return results;
     }
 };
 //# sourceMappingURL=spo.js.map

package/dist/utils/zod.js

@@ -1,114 +1,74 @@
 import { z } from 'zod';
-function parseEffect(def, _options, _currentOption) {
-    return def.schema._def;
-}
-function parseIntersection(def, _options, _currentOption) {
-    if (def.left._def.typeName !== z.ZodFirstPartyTypeKind.ZodAny) {
-        return def.left._def;
-    }
-    if (def.right._def.typeName !== z.ZodFirstPartyTypeKind.ZodAny) {
-        return def.right._def;
-    }
-    return;
-}
-function parseObject(def, options, _currentOption) {
-    const properties = def.shape();
-    for (const key in properties) {
-        const property = properties[key];
+z.ZodType.prototype.alias = function (name) {
+    this.def.alias = name;
+    return this;
+};
+function parseObject(schema, options, _currentOption) {
+    for (const key in schema.properties) {
+        const property = schema.properties[key];
         const option = {
             name: key,
             long: key,
-            short: property._def.alias,
-            required: true,
+            short: property['x-alias'],
+            required: schema.required?.includes(key) && property.default === undefined || false,
             type: 'string'
         };
-        parseDef(property._def, options, option);
+        parseJSONSchema(property, options, option);
         options.push(option);
     }
     return;
 }
-function parseString(_def, _options, currentOption) {
+function parseString(schema, _options, currentOption) {
     if (currentOption) {
         currentOption.type = 'string';
+        if (schema.enum) {
+            currentOption.autocomplete = schema.enum.map(e => String(e));
+        }
     }
     return;
 }
-function parseNumber(_def, _options, currentOption) {
+function parseNumber(schema, _options, currentOption) {
     if (currentOption) {
         currentOption.type = 'number';
     }
     return;
 }
-function parseBoolean(_def, _options, currentOption) {
+function parseBoolean(schema, _options, currentOption) {
     if (currentOption) {
         currentOption.type = 'boolean';
     }
     return;
 }
-function parseOptional(def, _options, currentOption) {
-    if (currentOption) {
-        currentOption.required = false;
-    }
-    return def.innerType._def;
-}
-function parseDefault(def, _options, currentOption) {
-    if (currentOption) {
-        currentOption.required = false;
-    }
-    return def.innerType._def;
-}
-function parseEnum(def, _options, currentOption) {
-    if (currentOption) {
-        currentOption.type = 'string';
-        currentOption.autocomplete = [...def.values];
-    }
-    return;
-}
-function parseNativeEnum(def, _options, currentOption) {
-    if (currentOption) {
-        currentOption.type = 'string';
-        currentOption.autocomplete = Object.values(def.values).map(v => String(v));
-    }
-    return;
-}
 function getParseFn(typeName) {
     switch (typeName) {
-        case z.ZodFirstPartyTypeKind.ZodEffects:
-            return parseEffect;
-        case z.ZodFirstPartyTypeKind.ZodObject:
+        case 'object':
             return parseObject;
-        case z.ZodFirstPartyTypeKind.ZodOptional:
-            return parseOptional;
-        case z.ZodFirstPartyTypeKind.ZodString:
+        case 'string':
             return parseString;
-        case z.ZodFirstPartyTypeKind.ZodNumber:
+        case 'number':
+        case 'integer':
             return parseNumber;
-        case z.ZodFirstPartyTypeKind.ZodBoolean:
+        case 'boolean':
             return parseBoolean;
-        case z.ZodFirstPartyTypeKind.ZodEnum:
-            return parseEnum;
-        case z.ZodFirstPartyTypeKind.ZodNativeEnum:
-            return parseNativeEnum;
-        case z.ZodFirstPartyTypeKind.ZodDefault:
-            return parseDefault;
-        case z.ZodFirstPartyTypeKind.ZodIntersection:
-            return parseIntersection;
         default:
             return;
     }
 }
-function parseDef(def, options, currentOption) {
-    let parsedDef = def;
+function parseJSONSchema(jsonSchema, options, currentOption) {
+    let parsedSchema = jsonSchema;
     do {
-        const parse = getParseFn(parsedDef.typeName);
+        if (parsedSchema.allOf) {
+            parsedSchema.allOf.forEach(s => parseJSONSchema(s, options, currentOption));
+        }
+        const parse = getParseFn(parsedSchema.type);
         if (!parse) {
             break;
         }
-        parsedDef = parse(parsedDef, options, currentOption);
-        if (!parsedDef) {
+        parsedSchema = parse(parsedSchema, options, currentOption);
+        if (!parsedSchema) {
             break;
         }
-    } while (parsedDef);
+    } while (parsedSchema);
 }
 function optionToString(optionInfo) {
     let s = '';
@@ -126,13 +86,18 @@ function optionToString(optionInfo) {
 }
 ;
 export const zod = {
-    alias(alias, type) {
-        type._def.alias = alias;
-        return type;
-    },
     schemaToOptionInfo(schema) {
+        const jsonSchema = z.toJSONSchema(schema, {
+            override: s => {
+                const alias = s.zodSchema.def.alias;
+                if (alias) {
+                    s.jsonSchema['x-alias'] = alias;
+                }
+            },
+            unrepresentable: 'any'
+        });
         const options = [];
-        parseDef(schema._def, options);
+        parseJSONSchema(jsonSchema, options);
         return options;
     },
     schemaToOptions(schema) {
@@ -153,6 +118,6 @@ export const zod = {
             }
         }
         return null;
-    }, z.nativeEnum(e))
+    }, z.enum(e))
 };
 //# sourceMappingURL=zod.js.map

package/docs/docs/cmd/entra/app/app-permission-add.mdx

@@ -46,6 +46,25 @@ m365 entra appregistration permission add [options]
 
 Scopes/Roles to grant must be fully-qualified so that we can disambiguate them between the different resources.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource         | Permissions               |
+  |------------------|---------------------------|
+  | Microsoft Graph  | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource         | Permissions               |
+  |------------------|---------------------------|
+  | Microsoft Graph  | Application.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Grant multiple delegated API permissions to a Microsoft Entra app specified by client id.

package/docs/docs/cmd/entra/app/app-permission-list.mdx

@@ -34,6 +34,25 @@ m365 entra app permission list [options]
 
 For best performance use the `objectId` option to reference the Entra application registration to get. If you use `appId`, this command will first need to find the corresponding object ID for that application.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource         | Permissions          |
+  |------------------|----------------------|
+  | Microsoft Graph  | Application.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource         | Permissions          |
+  |------------------|----------------------|
+  | Microsoft Graph  | Application.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieves all permissions for an Entra application registration specified by client id.

package/docs/docs/cmd/entra/app/app-permission-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra app permission remove
 
@@ -41,6 +43,25 @@ m365 entra app permission remove [options]
 
 Removing permissions on App Registrations does not immediately remove consent given by an administrator. Explicitly instruct the CLI to revoke consent by using the `--revokeAdminConsent` flag.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource         | Permissions               |
+  |------------------|---------------------------|
+  | Microsoft Graph  | Application.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource         | Permissions               |
+  |------------------|---------------------------|
+  | Microsoft Graph  | Application.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove multiple delegated API permissions from an Entra app registration

package/docs/docs/cmd/spo/file/file-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file add
 
@@ -28,6 +30,12 @@ m365 spo file add [options]
 `--checkOut [checkOut]`
 : If versioning is enabled, this will check out the file first if it exists, upload the file, then check it in again.
 
+`--overwrite [overwrite]`
+: Overwrite the file if it already exists in the target folder. Possible values: `true`, `false`. Default is `true`.
+
+`--fileName [fileName]`
+: The name of the file in SharePoint after upload. If not specified, the name of the uploaded file will be used.
+
 `--checkInComment [checkInComment]`
 : Comment to set when checking the file in.
 
@@ -50,6 +58,25 @@ m365 spo file add [options]
 
 This command allows using unknown properties. Each property corresponds to the list item field that should be set when uploading the file.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Adds the specified file to the specified site in the specified folder.
@@ -70,6 +97,12 @@ Adds the specified file to the specified site in the specified folder specifying
 m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder '/sites/project-x/Shared Documents' --path 'C:\MS365.jpg'
 ```
 
+Uploads a file to SharePoint with a different name.
+
+```sh
+m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --path 'C:\MS365.jpg' --fileName 'MS365-New.jpg'
+```
+
 Adds the specified file to the specified site in the specified folder with specified content type.
 
 ```sh
@@ -156,7 +189,113 @@ m365 spo file add --webUrl https://contoso.sharepoint.com/sites/project-x --fold
 
 ## Response
 
-The command won't return a response on success.
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "CheckInComment": "",
+    "CheckOutType": 2,
+    "ContentTag": "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5",
+    "CustomizedPageStatus": 0,
+    "ETag": "\"{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2\"",
+    "Exists": true,
+    "ExistsAllowThrowForPolicyFailures": true,
+    "ExistsWithException": true,
+    "IrmEnabled": false,
+    "Length": "19555",
+    "Level": 1,
+    "LinkingUri": "https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799",
+    "LinkingUrl": "https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799",
+    "MajorVersion": 1,
+    "MinorVersion": 0,
+    "Name": "Yearly report.xlsx",
+    "ServerRelativeUrl": "/sites/Finance/YearlyReports/Yearly report.xlsx",
+    "TimeCreated": "2026-01-07T10:50:38Z",
+    "TimeLastModified": "2026-01-07T10:50:38Z",
+    "Title": "",
+    "UIVersion": 512,
+    "UIVersionLabel": "1.0",
+    "UniqueId": "56b8e3c8-8e8a-4600-b9e1-a63d27391799"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  CheckInComment                   :
+  CheckOutType                     : 2
+  ContentTag                       : {56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5
+  CustomizedPageStatus             : 0
+  ETag                             : "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2"
+  Exists                           : true
+  ExistsAllowThrowForPolicyFailures: true
+  ExistsWithException              : true
+  IrmEnabled                       : false
+  Length                           : 19555
+  Level                            : 1
+  LinkingUri                       : https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  LinkingUrl                       : https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  MajorVersion                     : 2
+  MinorVersion                     : 0
+  Name                             : Yearly report.xlsx
+  ServerRelativeUrl                : /sites/Finance/YearlyReports/Yearly report.xlsx
+  TimeCreated                      : 2026-01-07T10:50:38Z
+  TimeLastModified                 : 2026-01-07T10:50:38Z
+  Title                            :
+  UIVersion                        : 512
+  UIVersionLabel                   : 1.0
+  UniqueId                         : 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,ExistsAllowThrowForPolicyFailures,ExistsWithException,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
+  ,2,"{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5",0,"""{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2""",1,1,1,0,19555,1,https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799,https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799,3,0,Yearly report.xlsx,/sites/Finance/YearlyReports/Yearly report.xlsx,2026-01-07T10:50:38Z,2026-01-07T10:50:38Z,,512,1.0,56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo file add --webUrl "https://contoso.sharepoint.com/sites/Finance" --folder "/YearlyReports" --path "C:\Yearly report.xlsx"
+
+  Date: 07/01/2026
+
+  ## 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+
+  Property | Value
+  ---------|-------
+  CheckInComment |
+  CheckOutType | 2
+  ContentTag | {56B8E3C8-8E8A-4600-B9E1-A63D27391799},2,5
+  CustomizedPageStatus | 0
+  ETag | "{56B8E3C8-8E8A-4600-B9E1-A63D27391799},2"
+  Exists | true
+  ExistsAllowThrowForPolicyFailures | true
+  ExistsWithException | true
+  IrmEnabled | false
+  Length | 19555
+  Level | 1
+  LinkingUri | https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly%20report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  LinkingUrl | https://contoso.sharepoint.com/sites/Finance/YearlyReports/Yearly report.xlsx?d=w56b8e3c88e8a4600b9e1a63d27391799
+  MajorVersion | 4
+  MinorVersion | 0
+  Name | Yearly report.xlsx
+  ServerRelativeUrl | /sites/Finance/YearlyReports/Yearly report.xlsx
+  TimeCreated | 2026-01-07T10:50:38Z
+  TimeLastModified | 2026-01-07T10:50:38Z
+  Title |
+  UIVersion | 512
+  UIVersionLabel | 1.0
+  UniqueId | 56b8e3c8-8e8a-4600-b9e1-a63d27391799
+  ```
+
+  </TabItem>
+</Tabs>
 
 ## More information
 

package/docs/docs/cmd/spo/list/list-defaultvalue-get.mdx

@@ -0,0 +1,118 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo list defaultvalue get
+
+Gets a specific default column value from a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName <fieldName>`
+: Internal name of the field.
+
+`--folderUrl [folderUrl]`
+: Get a specific field of a specific folder by specifying a server- or site-relative URL.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Get default column value from the root folder of the list
+
+```sh
+m365 spo list defaultvalue get --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company
+```
+
+Get default column value from a specific folder of the list
+
+```sh
+m365 spo list defaultvalue get --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company --folderUrl "/sites/Marketing/Logos/Contoso"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "fieldName": "Company",
+    "fieldValue": "Contoso",
+    "folderUrl": "sites/Marketing/Logos"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  fieldName : Company
+  fieldValue: Contoso
+  folderUrl : sites/Marketing/Logos
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  fieldName,fieldValue,folderUrl
+  Company,Contoso,sites/Marketing/Logos
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo list defaultvalue get --webUrl "https://contoso.sharepoint.com/sites/Marketing" --listTitle "Logos" --fieldName "Company"
+
+  Date: 2/20/2023
+
+  Property | Value
+  ---------|-------
+  fieldName | Company
+  fieldValue | Contoso
+  folderUrl | sites/Marketing/Logos
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spo/page/page-header-set.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo page header set
 
@@ -40,11 +42,14 @@ m365 spo page header set [options]
 `--textAlignment [textAlignment]`
 : How to align text in the header. Allowed values `Center`, `Left`. Default `Left`.
 
-`--showTopicHeader`
-: Set, to show the topic header.
+`--showTopicHeader [showTopicHeader]`
+: Show the topic header. Valid values: `true`, `false`. Defaults to `false`.
 
-`--showPublishDate`
-: Set, to show the publishing date.
+`--showPublishDate [showPublishDate]`
+: Show the publishing date. Valid values: `true`, `false`. Defaults to `false`.
+
+`--showTimeToRead [showTimeToRead]`
+: Show the estimated time to read the page. Valid values: `true`, `false`. Defaults to `false`.
 
 `--topicHeader [topicHeader]`
 : Text to show in the topic header, when `showTopicHeader` is set.
@@ -55,9 +60,24 @@ m365 spo page header set [options]
 
 <Global />
 
-## Remarks
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
 
-If the specified `name` doesn't refer to an existing modern page, you will get a `File doesn't exists` error.
+  </TabItem>
+</Tabs>
 
 ## Examples
 
@@ -79,10 +99,10 @@ Use the specified image focused on the given coordinates in the page header
 m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --type Custom --imageUrl /sites/team-a/SiteAssets/hero.jpg --altText 'Sunset over the ocean' --translateX 42.3837520042758 --translateY 56.4285714285714
 ```
 
-Center the page title in the header and show the publishing date
+Center the page title in the header and show the publishing date and time to read
 
 ```sh
-m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --textAlignment Center --showPublishDate
+m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --textAlignment Center --showPublishDate true --showTimeToRead true
 ```
 
 ## Response