Skip to content

channel-get-filesfolder.md

Latest commit

 

History

History
152 lines (119 loc) · 6.06 KB

channel-get-filesfolder.md

File metadata and controls

152 lines (119 loc) · 6.06 KB
title Get filesFolder
description Retrieve the filesFolder of a channel.
author MSFTRickyCastaneda
ms.localizationpriority high
ms.subservice teams
doc_type apiPageType
ms.date 08/19/2024

Get filesFolder

Namespace: microsoft.graph

Get the metadata for the location where the files of a channel are stored.

Note

Some special characters in the channel name will cause this API to return an error. For details, see Known issues.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

Note

The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward.

HTTP request

GET /teams/{id}/channels/{id}/filesFolder

Optional query parameters

This method doesn't support the OData query parameters to customize the response.

Request headers

Header Value
Authorization Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a driveItem object in the response body.

Note

  • For private channels created before the move to group compliance as part of enhancements, a dedicated folder that matches the channel name may still exist. Any files uploaded before the enhancement remain in this folder.

  • After a private channel is migrated, the default file location changes to the root folder, and the GET /teams/{team-id}/channels/{channel-id}/filesFolder API returns the root folder’s driveItem. Newly created private channels (post‑migration) no longer create a dedicated folder. All files are stored in the root folder, and the API returns the root folder’s driveItem.

For more details about private channel enhancements and migration, see New enhancements in private channels in Microsoft Teams.

Example

Request

The following example shows a request.

HTTP

GET https://graph.microsoft.com/v1.0/teams/{id}/channels/{id}/filesFolder

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('32e3b156-66b2-4135-9aeb-73295a35a55b')/channels('19%3Af253e46c035b42308e9a4a22a87037af%40thread.skype')/filesFolder/$entity",
    "id": "01H7CFEKENJSSIUHGADZBKODARINQC5JMD",
    "createdDateTime": "0001-01-01T00:00:00Z",
    "lastModifiedDateTime": "2020-01-23T18:47:13Z",
    "name": "Documentation Planning",
    "webUrl": "https://microsoft.sharepoint.com/teams/ExtensibilityandFundamentals/Shared%20Documents/Documentation%20Planning",
    "size": 2374080,
    "parentReference": {
        "driveId": "b!2SInBlQrN0K8-GXMy9qNsPtI5ScW8C5IlZtycoy6ZpJZRRtgE4qVTrE8wrvL0-hd",
        "driveType": "documentLibrary"
    },
    "fileSystemInfo": {
        "createdDateTime": "2020-01-23T18:47:12Z",
        "lastModifiedDateTime": "2020-01-23T18:47:13Z"
    },
    "folder": {
        "childCount": 7
    }
}