@pnp/cli-microsoft365 6.0.0-beta.ff232be → 6.1.0-beta.11542c0

package/docs/docs/cmd/spo/list/list-webhook-list.md

@@ -11,32 +11,67 @@ m365 spo list webhook list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to retrieve webhooks for is located
+: URL of the site where the list is located.
 
 `-i, --listId [listId]`
-: ID of the list to retrieve all webhooks for. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list to retrieve all webhooks for. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
-`--id [id]`
-: (deprecated. Use `listId` instead) ID of the list to retrieve all webhooks for. Specify either `id` or `title` but not both
-
-`--title [title]`
-: (deprecated. Use `listTitle` instead) Title of the list to retrieve all webhooks for. Specify either `id` or `title` but not both
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-List all webhooks for a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
+List all webhooks for a list with a specific ID in a specific site
 
 ```sh
 m365 spo list webhook list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf
 ```
 
-List all webhooks for a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+List all webhooks for a list with a specific title in a specific site
 
 ```sh
 m365 spo list webhook list --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle Documents
 ```
+
+List all webhooks for a list with a specific URL in a specific site
+
+```sh
+m365 spo list webhook list --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Documents'
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "clientState": "system-managed:8082D436-D8DA-458D-96AD-34C902B73F37",
+        "expirationDateTime": "2022-11-16T20:25:12.2735056Z",
+        "id": "b8838bbb-9ddb-44fb-9016-0aacb9e02b77",
+        "notificationUrl": "https://northeurope1-0.pushnp.svc.ms/notifications?token=1e263e06-4bea-4da1-9f9f-5c8f713eef76",
+        "resource": "97d19285-b8a6-4c7f-9c6c-d6b850a6561a",
+        "resourceData": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    clientState                                          expirationDateTime            id                                    resource
+    ---------------------------------------------------  ----------------------------  ------------------------------------  ------------------------------------
+    system-managed:8082D436-D8DA-458D-96AD-34C902B73F37  2022-11-16T20:25:12.2735056Z  b8838bbb-9ddb-44fb-9016-0aacb9e02b77  97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,clientState,expirationDateTime,resource
+    b8838bbb-9ddb-44fb-9016-0aacb9e02b77,system-managed:8082D436-D8DA-458D-96AD-34C902B73F37,2022-11-16T20:25:12.2735056Z,97d19285-b8a6-4c7f-9c6c-d6b850a6561a
+    ```

package/docs/docs/cmd/spo/list/list-webhook-remove.md

@@ -11,19 +11,22 @@ m365 spo list webhook remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list to remove the webhook from is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list from which the webhook should be removed. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which the webhook should be removed. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-i, --id <id>`
-: ID of the webhook to remove
+: ID of the webhook.
 
 `--confirm`
-: Don't prompt for confirming removing the webhook
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,20 +36,23 @@ If the specified id doesn't refer to an existing webhook, you will get a `404 -
 
 ## Examples
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_
+Remove webhook with a specific ID from a list retrieved by ID in a specific site
 
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_
-
+Remove webhook with a specific ID from a list retrieved by Title in a specific site
 ```sh
 m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81
 ```
 
-Remove webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ without being asked for confirmation
+Remove webhook with a specific ID from a list retrieved by URL in a specific site without being asked for confirmation
 
 ```sh
-m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
+m365 spo list webhook remove --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/list/list-webhook-set.md

@@ -11,22 +11,28 @@ m365 spo list webhook set [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the list which contains the webhook is located
+: URL of the site where the list is located.
 
 `-l, --listId [listId]`
-: ID of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: ID of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
 `-t, --listTitle [listTitle]`
-: Title of the list which contains the webhook which should be updated. Specify either `listId` or `listTitle` but not both
+: Title of the list. Specify either `listId`, `listTitle` or `listUrl`.
 
-`-i, --id [id]`
-: ID of the webhook to update
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listId`, `listTitle` or `listUrl`.
+
+`-i, --id <id>`
+: ID of the webhook to update.
 
 `-n, --notificationUrl [notificationUrl]`
-: The new notification url
+: The new notification url.
 
 `-e, --expirationDateTime [expirationDateTime]`
-: The new expiration date
+: The new expiration date. _Note: Expiration Time cannot be more than 6 months in future_
+
+`-c, --clientState [clientState]`
+: A client state information that will be passed through notifications.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -36,21 +42,24 @@ If the specified `id` doesn't refer to an existing webhook, you will get a `404
 
 ## Examples
 
-Update the notification url of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _https://contoso-functions.azurewebsites.net/webhook_
+Update the notification url of a webhook with a specific ID attached to a list with a specific ID in a specific site to a specific URL
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listId 0cd891ef-afce-4e55-b836-fce03286cccf --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook
 ```
 
-Update the expiration date of a webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ to _October 9th, 2018 at 6:15 PM_
+Update the expiration date of a webhook with a specific ID attached to a list with a specific title in a specific site to a specfic date
 
 ```sh
 m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --expirationDateTime 2018-10-09T18:15
 ```
 
-From the webhook with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ which belongs to a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/ninja_ update the notification url to _https://contoso-functions.azurewebsites.net/webhook_
-and the expiration date to _March 2nd, 2019_
+Update the notification url and clientState of a webhook with a specific ID attached to a list with a specific URL in a specific site to a specific URL and the expiration date to a specific date
 
 ```sh
-m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listTitle Documents --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02
+m365 spo list webhook set --webUrl https://contoso.sharepoint.com/sites/ninja --listUrl '/sites/ninja/Documents' --id cc27a922-8224-4296-90a5-ebbc54da2e81 --notificationUrl https://contoso-functions.azurewebsites.net/webhook --expirationDateTime 2019-03-02 --clientState 'My client state'
 ```
+
+## Respone
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/listitem/listitem-add.md

@@ -14,10 +14,13 @@ m365 spo listitem add [options]
 : URL of the site where the item should be added
 
 `-l, --listId [listId]`
-: ID of the list where the item should be added. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list where the item should be added. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-c, --contentType [contentType]`
 : The name or the ID of the content type to associate with the new item
@@ -64,3 +67,68 @@ Add an item with Title _Demo Hyperlink Field_ and a hyperlink field named _Custo
 ```sh
 m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --CustomHyperlink "https://www.bing.com, Bing"
 ```
+
+Add an item with a specific title to a list retrieved by server-relative URL in a specific site
+
+```sh
+m365 spo listitem add --contentType Item --listUrl /sites/project-x/Documents --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Item"
+```
+
+Add an item with a specific Title and multi-choice value
+
+```sh
+m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Hyperlink Field" --MultiChoiceField "Choice 1;#Choice 2;#Choice 3"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 234,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ID": 234,
+      "ContentTypeId": "0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803",
+      "Title": "Test",
+      "Modified": "2022-11-16T20:55:45Z",
+      "Created": "2022-11-16T20:55:45Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "1.0",
+      "Attachments": false,
+      "GUID": "352e3855-56fa-4b68-b6be-4644d6adf204",
+      "ComplianceAssetId": null,
+      "OData__vti_ItemDeclaredRecord": null,
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments                  : false
+    AuthorId                     : 10
+    ComplianceAssetId            : null
+    ContentTypeId                : 0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803
+    Created                      : 2022-11-16T20:56:31Z
+    EditorId                     : 10
+    FileSystemObjectType         : 0
+    GUID                         : cac57513-e870-4e7a-9f23-f4ea10e14f4e
+    ID                           : 236
+    Id                           : 236
+    Modified                     : 2022-11-16T20:56:31Z
+    OData__UIVersionString       : 1.0
+    OData__vti_ItemDeclaredRecord: null
+    ServerRedirectedEmbedUri     : null
+    ServerRedirectedEmbedUrl     :
+    Title                        : Test
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,OData__vti_ItemDeclaredRecord
+    0,235,,,235,0x01003CDBEB7138618C47A98D56499135D6EE0004C0F5794DEBCC4BAC981AC4AE1BD803,Test,2022-11-16T20:56:09Z,2022-11-16T20:56:09Z,10,10,1.0,,7aa8f3bd-a0a2-4974-81c8-2ac7ddc8e2d8,,
+    ```

package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md

@@ -14,10 +14,13 @@ m365 spo listitem attachment list [options]
 URL of the site from which the item should be retrieved
 
 `--listId [listId]`
-: ID of the list from which to retrieve the item. Specify listId or listTitle but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listTitle [listTitle]`
-: Title of the list from which to retrieve the item. Specify listId or listTitle but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--itemId <itemId>`
 ID of the list item to in question
@@ -37,3 +40,43 @@ Gets the attachments from list item with itemId _147_ in list with id _0cd891ef-
 ```sh
 m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --itemId 147
 ```
+
+Gets the attachments from a specific list item in a specific list obtained by server-relative URL in a specific site
+
+```sh
+m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/Documents --itemId 147
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "FileName": "DummyDocument.docx",
+        "FileNameAsPath": {
+          "DecodedUrl": "DummyDocument.docx"
+        },
+        "ServerRelativePath": {
+          "DecodedUrl": "/Lists/Test/Attachments/236/DummyDocument.docx"
+        },
+        "ServerRelativeUrl": "/Lists/Test/Attachments/236/DummyDocument.docx"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    FileName            ServerRelativeUrl  
+    ------------------  ----------------------------------------------
+    DummyDocument.docx  /Lists/Test/Attachments/236/DummyDocument.docx
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileName,ServerRelativeUrl
+    DummyDocument.docx,/Lists/Test/Attachments/236/DummyDocument.docx
+    ```

package/docs/docs/cmd/spo/listitem/listitem-batch-add.md

@@ -0,0 +1,61 @@
+# spo listitem batch add
+
+Creates list items in a batch
+
+## Usage
+
+```sh
+m365 spo listitem batch add [options]
+```
+
+## Options
+
+`-p, --filePath <filePath>`
+: The absolute or relative path to a flat file containing the list items.
+
+`-u, --webUrl <webUrl>`
+: URL of the site.
+
+`-l, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`, but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Add a batch of items to a list retrieved by title in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List"
+```
+
+Add a batch of items to a list retrieved by Id in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listId fe54c47b-22e4-4cab-8a10-3fc54003fb4c
+```
+
+Add a batch of items to a list defined by server-relative URL in a specific site
+
+```sh
+m365 spo listitem batch add --filePath "C:\Path\To\Csv\CsvFile.csv" --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/sites/project-x/lists/Demo List"
+```
+
+## Remarks
+
+A sample CSV can be found below. The first line of the CSV-file should contain the internal column names that you wish to set.
+
+```csv
+ContentType,Title,SingleChoiceField,MultiChoiceField,SingleMetadataField,MultiMetadataField,SinglePeopleField,MultiPeopleField,CustomHyperlink,NumberField
+Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|adamb@contoso.com'}]","https://bing.com, URL",5
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/listitem/listitem-get.md

@@ -17,14 +17,20 @@ m365 spo listitem get [options]
 : ID of the item to retrieve.
 
 `-l, --listId [listId]`
-: ID of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
 
 `-t, --listTitle [listTitle]`
-: Title of the list from which to retrieve the item. Specify `listId` or `listTitle` but not both
+: Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested
 
+`--withPermissions`
+: Set if you want to return associated roles and permissions
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -33,20 +39,207 @@ If you want to specify a lookup type in the `properties` option, define which co
 
 ## Examples
 
-Get an item with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
 
-Get an items _Title_ and _Created_ column with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
 ```
 
-Get an items _Title_, _Created_ column and lookup column _Company_ with ID _147_ from list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+Get an item columns and lookup column with the ID parameter from a given list in a given site
 
 ```sh
 m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
 ```
+
+Get an item with specific properties from a given list based on the server-relative URL in a specific site
+
+```sh
+m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
+```
+
+Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions
+
+```sh
+m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
+```
+
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,
+    ```
+
+### `withPermissions` response
+
+When we make use of the option `withPermissions` the response will differ. 
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "FileSystemObjectType": 0,
+      "Id": 147,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ContentTypeId": "0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126",
+      "Title": "Demo Item",
+      "Modified": "2022-10-30T10:55:37Z",
+      "Created": "2022-10-30T10:55:22Z",
+      "AuthorId": 10,
+      "EditorId": 10,
+      "OData__UIVersionString": "3.0",
+      "Attachments": false,
+      "GUID": "87f3138d-fac3-4126-97c0-543e55672261",
+      "ComplianceAssetId": null,
+      "RoleAssignments": [
+        {
+          "Member": {
+            "Id": 3,
+            "IsHiddenInUI": false,
+            "LoginName": "Communication site Owners",
+            "Title": "Communication site Owners",
+            "PrincipalType": 8,
+            "AllowMembersEditMembership": false,
+            "AllowRequestToJoinLeave": false,
+            "AutoAcceptRequestToJoinLeave": false,
+            "Description": null,
+            "OnlyAllowMembersViewMembership": false,
+            "OwnerTitle": "Communication site Owners",
+            "RequestToJoinLeaveEmailSetting": ""
+          },
+          "RoleDefinitionBindings": [
+            {
+              "BasePermissions": {
+                "High": "2147483647",
+                "Low": "4294967295"
+              },
+              "Description": "Has full control.",
+              "Hidden": false,
+              "Id": 1073741829,
+              "Name": "Full Control",
+              "Order": 1,
+              "RoleTypeKind": 5,
+              "BasePermissionsValue": [
+                "ViewListItems",
+                "AddListItems",
+                "EditListItems",
+                "DeleteListItems",
+                "ApproveItems",
+                "OpenItems",
+                "ViewVersions",
+                "DeleteVersions",
+                "CancelCheckout",
+                "ManagePersonalViews",
+                "ManageLists",
+                "ViewFormPages",
+                "AnonymousSearchAccessList",
+                "Open",
+                "ViewPages",
+                "AddAndCustomizePages",
+                "ApplyThemeAndBorder",
+                "ApplyStyleSheets",
+                "ViewUsageData",
+                "CreateSSCSite",
+                "ManageSubwebs",
+                "CreateGroups",
+                "ManagePermissions",
+                "BrowseDirectories",
+                "BrowseUserInfo",
+                "AddDelPrivateWebParts",
+                "UpdatePersonalWebParts",
+                "ManageWeb",
+                "AnonymousSearchAccessWebLists",
+                "UseClientIntegration",
+                "UseRemoteAPIs",
+                "ManageAlerts",
+                "CreateAlerts",
+                "EditMyUserInfo",
+                "EnumeratePermissions"
+              ],
+              "RoleTypeKindValue": "Administrator"
+            }
+          ],
+          "PrincipalId": 3
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    Attachments             : false
+    AuthorId                : 10
+    ComplianceAssetId       : null
+    ContentTypeId           : 0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126
+    Created                 : 2022-10-30T10:55:22Z
+    EditorId                : 10
+    FileSystemObjectType    : 0
+    GUID                    : 87f3138d-fac3-4126-97c0-543e55672261
+    Id                      : 147
+    Modified                : 2022-10-30T10:55:37Z
+    OData__UIVersionString  : 3.0
+    RoleAssignments         : [{"Member":{"Id":3,"IsHiddenInUI":false,"LoginName":"Communication site Owners","Title":"Communication site Owners","PrincipalType":8,"AllowMembersEditMembership":false,"AllowRequestToJoinLeave":false,"AutoAcceptRequestToJoinLeave":false,"Description":null,"OnlyAllowMembersViewMembership":false,"OwnerTitle":"Communication site Owners","RequestToJoinLeaveEmailSetting":""},"RoleDefinitionBindings":[{"BasePermissions":{"High":"2147483647","Low":"4294967295"},"Description":"Has full control.","Hidden":false,"Id":1073741829,"Name":"Full Control","Order":1,"RoleTypeKind":5,"BasePermissionsValue":["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"],"RoleTypeKindValue":"Administrator"}],"PrincipalId":3}]
+    ServerRedirectedEmbedUri: null
+    ServerRedirectedEmbedUrl:
+    Title                   : Demo Item
+    ```
+
+=== "CSV"
+
+    ```csv
+    FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,RoleAssignments
+    0,147,,,0x010078BC2C6F12F0DB41BA554210A2BFA81600A320A11ABE6E90468525ECC747660126,Demo Item,2022-10-30T10:55:37Z,2022-10-30T10:55:22Z,10,10,3.0,,87f3138d-fac3-4126-97c0-543e55672261,"[{""Member"":{""Id"":3,""IsHiddenInUI"":false,""LoginName"":""Communication site Owners"",""Title"":""Communication site Owners"",""PrincipalType"":8,""AllowMembersEditMembership"":false,""AllowRequestToJoinLeave"":false,""AutoAcceptRequestToJoinLeave"":false,""Description"":null,""OnlyAllowMembersViewMembership"":false,""OwnerTitle"":""Communication site Owners"",""RequestToJoinLeaveEmailSetting"":""""},""RoleDefinitionBindings"":[{""BasePermissions"":{""High"":""2147483647"",""Low"":""4294967295""},""Description"":""Has full control."",""Hidden"":false,""Id"":1073741829,""Name"":""Full Control"",""Order"":1,""RoleTypeKind"":5,""BasePermissionsValue"":[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""],""RoleTypeKindValue"":""Administrator""}],""PrincipalId"":3}]"
+    ```