Current section
Files
Jump to
Current section
Files
priv/docs/methods/files.remote.share.json
{
"args": {
"channels": {
"desc": "Comma-separated list of channel IDs where the file will be shared.",
"required": true,
"type": "string"
},
"external_id": {
"desc": "The globally unique identifier (GUID) for the file, as set by the app registering the file with Slack. Either this field or `file` or both are required.",
"example": "123456",
"required": false,
"type": "string"
},
"file": {
"desc": "Specify a file registered with Slack by providing its ID. Either this field or `external_id` or both are required.",
"example": "F2147483862",
"required": false,
"type": "string"
}
},
"desc": "Share a remote file into a channel.",
"errors": {
"channel_not_found": "At least one of the values passed for `channels` was invalid.",
"file_not_found": "No file with the requested ID found.",
"invalid_args": "Invalid arguments passed to endpoint",
"no_bot_user_for_app": "Cannot call the Remote Files endpoints unless app has associated bot user",
"not_in_channel": "Authenticated user is not in at least one of the the provided channels."
},
"rate_limit": {
"label": "Tier 2: 20+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"bot": [
{
"name": "remote_files:share",
"url": "https://docs.slack.dev/reference/scopes/remote_files.share"
}
],
"user": [
{
"name": "remote_files:share",
"url": "https://docs.slack.dev/reference/scopes/remote_files.share"
}
]
}
}