Slack.Web.Files (SlackKit v0.25.0-alpha.0)

blocks - A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initial_comment field is provided, the blocks field is ignored ex: [{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]
channel_id - Channel ID where the file will be shared. If not specified the file will be private. ex: C0NF841BK
channels - Comma-separated string of channel IDs or user IDs where the file will be shared. ex: C0NF841BK,C2AW648GH
initial_comment - The message text introducing the file in specified channels.
thread_ts - Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead. Also make sure to provide only one channel when using 'thread_ts' ex: 1524523204.000192

Errors the API can return:

channels_limit_exceeded - Exceeded the channel limit. A maximum of 100 channels is allowed per request.
token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
file_type_not_allowed - The file type is not permitted based on the team's allowed_file_upload_types preference.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
invalid_blocks - Provided blocks are in the incorrect format.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
file_uploads_except_images_disabled - Only image file uploads are permitted for this team.
not_in_channel - User/bot membership is required for the specified channel.
posting_to_channel_denied - User is not authorized to post to channel.
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
channel_not_found - Value passed for channel_id was invalid.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - User is not the owner of the file.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
invalid_channel - Channel could not be found or channel specified is invalid.
method_deprecated - The method has been deprecated.
file_update_failed - Failure occurred when attempting to update the file.
file_not_found - Could not find the file from the upload ticket.
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.

delete(file, optional_params \\ %{})

Deletes a file.

Required Params

file - ID of file to delete.

Errors the API can return:

token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
cant_delete_file - Authenticated user does not have permission to delete this file.
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
file_deleting_disabled - This functionality is disabled.
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Access to a resource specified in the request is denied.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
file_deleted - The file has already been deleted.
delete_not_allowed - Error returned when the requested file does not support deletion; for example, when attempting to delete a canvas template.
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
method_deprecated - The method has been deprecated.
file_not_found - The file does not exist, or is not visible to the calling user.
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.

get_upload_url_external(filename, length, optional_params \\ %{})

Gets a URL for an edge external file upload

Required Params

filename - Name of the file being uploaded. ex: laughingoutloudcat.jpg
length - Size in bytes of the file being uploaded. ex: 53072

Optional Params

alt_txt - Description of image for screen-reader. ex: Aerial view of the Bixby Bridge and coastline of the Big Sur area in California
snippet_type - Syntax type of the snippet being uploaded. ex: python

Errors the API can return:

alt_txt_too_large - Description for the image is longer than the limit of 1000 character
unknown_snippet_type - The provided snippet_type is not a supported type.
token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
file_type_not_allowed - The file type is not allowed.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
storage_limit_reached - File storage limit has been reached. This occurs when free teams have uploaded 5GB of files.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
snippet_too_large - The provided length is too large to create a snippet, which are limited to 1MB.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
file_uploads_except_images_disabled - File uploads except images are disabled.
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
invalid_arguments - The method was called with invalid arguments.
file_uploads_disabled - Team has disabled all file uploads.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
unknown_subtype - The provided subtype is not a supported type.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Access to a resource specified in the request is denied.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
file_upload_size_restricted - The size of provided file is too large, as the team has restricted uploads of large files.
method_deprecated - The method has been deprecated.
missing_argument - A required argument was not provided. Typically only occurs when the length provided is 0.
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.

info(file, optional_params \\ %{})

Gets information about a file.

Required Params

file - Specify a file by providing its ID. ex: F2147483862

Optional Params

count -
cursor - Parameter for pagination. File comments are paginated for a single file. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection of comments. See pagination for more details. ex: dXNlcjpVMDYxTkZUVDI=
limit - The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.

0 ex: 20

page -

Errors the API can return:

template_not_visible - Do not have permissions to view this template
token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
canvas_disabled_user_team - Canvas is disabled on user's team for connected Channels
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
slack_connect_canvas_sharing_blocked - Admin has disabled sharing of Canvas links in all Slack Connect communications
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
invalid_arguments - The method was called with invalid arguments.
not_visible - Do not have permission to view the file
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Unable to access the file (slack connect)
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
canvas_globally_disabled - Canvas is disabled for this team
token_expired - Authentication token has expired
file_deleted - The requested file has been deleted
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
method_deprecated - The method has been deprecated.
file_not_found - Value passed for file was invalid
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.
canvas_disabled_file_team - Canvas is disabled on file's team

list(optional_params \\ %{})

List files for a team, in a channel, or from a user with applied filters.

Optional Params

channel - Filter files appearing in a specific channel, indicated by its ID.
count -
page -
show_files_hidden_by_limit - Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit. ex: true
team_id - encoded team id to list files in, required if org token is used
ts_from - Filter files created after this timestamp (inclusive). ex: 123456789
ts_to - Filter files created before this timestamp (inclusive). ex: 123456789
types - Filter files by type (see below). You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list. ex: images
user - Filter files created by a single user.

Errors the API can return:

token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
slack_connect_canvas_sharing_blocked - Admin has disabled sharing of Canvas links in all Slack Connect communications
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
user_not_found - Value passed for user was invalid
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
unknown_type - Value passed for types was invalid
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Access to a resource specified in the request is denied.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
method_deprecated - The method has been deprecated.
missing_argument - A required argument is missing.
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.

revoke_public_url(file, optional_params \\ %{})

Revokes public/external sharing access for a file

Required Params

file - File to revoke

Errors the API can return:

access_denied - Access to a resource specified in the request is denied.
accesslimited - Access to this method is limited on the current network
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
deprecated_endpoint - The endpoint has been deprecated.
ekm_access_denied - Administrators have suspended the ability to post a message.
enterprise_is_restricted - The method cannot be called from an Enterprise.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
file_not_found - Value passed for file was invalid
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
method_deprecated - The method has been deprecated.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
not_allowed_token_type - The token type used in this request is not allowed.
not_authed - No authentication token provided.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
service_unavailable - The service is temporarily unavailable
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
token_expired - Authentication token has expired
token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
two_factor_setup_required - Two factor setup is required.

shared_public_url(file, optional_params \\ %{})

Enables a file for public/external sharing.

Required Params

file - File to share

Errors the API can return:

token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
public_file_type_not_allowed - Public sharing has been restricted for this file type.
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
public_video_not_allowed - Public sharing of videos is not available. A Free instance of Slack may encounter this error because free teams don't have the ability to share video files publicly.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Access to a resource specified in the request is denied.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
not_allowed - Public sharing has been disabled for this team. You may see this error if you are creating an external link from a free or trial workspace. You can either upgrade to a Paid Plan or use file.list to get a url_private_download link, download the file with an application, and re-upload it somewhere it can be shared with users who are not members of your workspace. Be sure to pass the Slack Bot token to the request on the headers file when calling url_private_download.
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
method_deprecated - The method has been deprecated.
file_not_found - Value passed for file was invalid
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.

upload(optional_params \\ %{})

Uploads or creates a file.

Optional Params

channels - Comma-separated list of channel names or IDs where the file will be shared.
content - File contents via a POST variable. If omitting this parameter, you must provide a file. You must provide either a file or content parameter. The content of the file can either be posted using an enctype of multipart/form-data (with the file parameter named file), in the usual way that files are uploaded via the browser, or the content of the file can be sent as a POST var called content. ex: ...
file - File contents via multipart/form-data. If omitting this parameter, you must submit content. You must provide either a file or content parameter. The content of the file can either be posted using an enctype of multipart/form-data (with the file parameter named file), in the usual way that files are uploaded via the browser, or the content of the file can be sent as a POST var called content. Possible filetype values can be found in the file object definition. ex: ...
filename - Filename of file. If you only specify a filename, we remove the file extension and populate the file's title with the remaining value. ex: foo.txt
filetype - A file type identifier. Possible filetype values can be found in the file object definition. ex: php
initial_comment - The message text introducing the file in specified channels. ex: Best!
thread_ts - Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.
title - Title of file. If you only specify a filename, we remove the file extension and populate the file's title with the remaining value. ex: My File

Errors the API can return:

malware_detected - This file may contain a virus or other malware and can't be uploaded to Slack
token_revoked - Authentication token is for a deleted user or workspace or the app has been removed when using a user token.
invalid_arg_name - The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.
two_factor_setup_required - Two factor setup is required.
invalid_thread_ts - Value passed to thread_ts was invalid
invalid_form_data - The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.
invalid_post_type - The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.
posting_to_general_channel_denied - An admin has restricted posting to the #general channel.
post_contents_too_large - File content is larger than 130kb.
fatal_error - The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.
slack_connect_blocked_file_type - File uploads with certain types are blocked in all Slack Connect communications
deprecated_endpoint - The endpoint has been deprecated.
ratelimited - The request has been ratelimited. Refer to the Retry-After header for when to retry the request.
ekm_access_denied - Administrators have suspended the ability to post a message.
service_unavailable - The service is temporarily unavailable
slack_connect_clip_sharing_blocked - Admin has disabled Clip sharing in Slack Connect channels
not_in_channel - Authenticated user is not in the channel.
team_access_not_granted - The token used is not granted the specific workspace access required to complete this request.
invalid_arguments - The method was called with invalid arguments.
invalid_array_arg - The method was passed an array as an argument. Please only input valid strings.
request_timeout - The method was called via a POST request, but the POST data was either missing or truncated.
account_inactive - Authentication token is for a deleted user or workspace when using a bot token.
slack_connect_file_upload_sharing_blocked - Admin has disabled File uploads in all Slack Connect communications
channel_not_found - At least one of the values passed for channels was invalid.
not_authed - No authentication token provided.
internal_error - The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.
enterprise_is_restricted - The method cannot be called from an Enterprise.
no_permission - The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.
access_denied - Access to a resource specified in the request is denied.
team_added_to_org - The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.
missing_scope - The token used is not granted the specific scope permissions required to complete this request.
missing_post_type - The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.
accesslimited - Access to this method is limited on the current network
token_expired - Authentication token has expired
invalid_charset - The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.
invalid_channel - One or more channels supplied are invalid
method_deprecated - This API is deprecated. Please refer to https://docs.slack.dev/changelog/2024-04-a-better-way-to-upload-files-is-here-to-stay
blocked_file_type - Admin has disabled uploading this type of file
not_allowed_token_type - The token type used in this request is not allowed.
org_login_required - The workspace is undergoing an enterprise migration and will not be available until migration is complete.
invalid_auth - Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.