Slack API · error code

Slack error file_uploads_disabled: Workspace has disabled file uploads

Policy / accountHTTP 200File uploads

Last verified against Slack API reference - chat.postMessage errors

What Slack returns
Team has disabled all file uploads.

What error file_uploads_disabled means

This workspace does not allow file uploads at all, so Slack will not give your app an upload URL. The files.getUploadURLExternal reference puts it plainly: "Team has disabled all file uploads." Your token, scopes and file are fine; a workspace admin has switched the feature off.

It appears at the first step of the upload flow, so nothing has been transferred yet. It often shows up as a support ticket from one customer while uploads work for everyone else, because it depends on that workspace's settings. The close relative file_uploads_except_images_disabled means images are allowed but other file types are not, and file_upload_size_restricted means only large files are blocked.

Do not retry. Deliver the content in another way, such as inline text, Block Kit, or a link to the file hosted elsewhere.

What it looks like

POST /api/files.getUploadURLExternal
filename=report.pdf&length=53072

{"ok": false, "error": "file_uploads_disabled"}

Why it happens

  • A workspace admin disabled file uploads for the whole team.
  • The app assumes uploads work everywhere because they work in the developer's own workspace.
  • A compliance policy changed after the app was installed.

How to fix Slack error file_uploads_disabled

  1. 1Catch this error per workspace and stop trying uploads there.
  2. 2Send the content another way: a text snippet in the message, Block Kit, or a link to hosted storage.
  3. 3Tell the person who configured the integration that uploads are disabled in their workspace.
  4. 4If uploads are essential, ask the workspace admin to review the file upload setting.

How to stop it recurring

Never make a file upload the only way your app delivers something. Build a link or text fallback from the start and record per workspace when uploads are blocked so the fallback is used without a failed call each time.

Official reference: Slack API reference - chat.postMessage errors. See all Slack error codes or the Slack limits and quotas.

Related codes

Error file_uploads_disabled - quick answers

What does Slack error file_uploads_disabled mean?

This workspace does not allow file uploads at all, so Slack will not give your app an upload URL. The files.getUploadURLExternal reference puts it plainly: "Team has disabled all file uploads." Your token, scopes and file are fine; a workspace admin has switched the feature off. It appears at the first step of the upload flow, so nothing has been transferred yet.

How do I fix Slack error file_uploads_disabled?

1. Catch this error per workspace and stop trying uploads there. 2. Send the content another way: a text snippet in the message, Block Kit, or a link to hosted storage. 3. Tell the person who configured the integration that uploads are disabled in their workspace. 4. If uploads are essential, ask the workspace admin to review the file upload setting.

Stop debugging Slack by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.