Skip to main content

files.remote.update method

Welcome to the new home of Slack developer docs!

We're still building and not all features are available quite yet. Enjoy this peek into the future!

Not ready for the future? Return to the past at api.slack.com.

Usage info​

This method updates a remote file.

You cannot update the external_id or file_id of a remote file. If you need to update those fields, you'll need to remove the file and then add it back.

Response​

{
"url": "",
"description": "Typical success response",
"example": {
    "ok": true,
    "file": {
        "id": "F08EAQ813FW",
        "created": 1740066121,
        "timestamp": 1740066121,
        "name": "Test",
        "title": "Test",
        "mimetype": "application/msword",
        "filetype": "doc",
        "pretty_type": "Word Document",
        "user": "U123A4BCDE5",
        "user_team": "T123A4BC5DE",
        "editable": false,
        "size": 0,
        "mode": "external",
        "is_external": true,
        "external_type": "app",
        "is_public": true,
        "public_url_shared": false,
        "display_as_bot": false,
        "username": "",
        "url_private": "https://docs.google.com/document/d/1e8LtkvCSe_NH0UU0RyLgssmUQLT8G_3RMCGzyPWcx58/edit?tab=t.0",
        "media_display_type": "unknown",
        "permalink": "https://thetestenv.slack.com/files/U123A4BCDE5/F08EAQ813FW/test",
        "comments_count": 0,
        "is_starred": false,
        "shares": {
            "public": {
                "C03QJUTKS4C": [
                    {
                        "reply_users": [],
                        "reply_users_count": 0,
                        "reply_count": 0,
                        "ts": "1740066131.886799",
                        "channel_name": "the-test-channel",
                        "team_id": "T123A4BC5DE",
                        "share_user_id": "U123A4BCDE5",
                        "source": "UNKNOWN"
                    }
                ],
                "C04567YFDK6": [
                    {
                        "reply_users": [],
                        "reply_users_count": 0,
                        "reply_count": 0,
                        "ts": "1740066131.650279",
                        "channel_name": "dev-test",
                        "team_id": "T123A4BC5DE",
                        "share_user_id": "U123A4BCDE5",
                        "source": "UNKNOWN"
                    }
                ]
            }
        },
        "channels": ["C12ABCDEF3G", "C12345ABCD6"],
        "groups": [],
        "ims": [],
        "has_more_shares": false,
        "external_id": "1234",
        "external_url": "https://docs.google.com/document/d/1e8LtkvCSe_NH0UU0RyLgssmUQLT8G_3RMCGzyPWcx58/edit?tab=t.0",
        "has_rich_preview": false,
        "file_access": "visible"
    }
}