Turn Off File Uploads for an Agent

If you no longer want your agent to be able to receive files, turn off file upload capabilities at the agent level.

Available in: Lightning Experience

Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.

User Permissions Needed
To turn off file uploads for an AI agent:	Manage AI Agents AND the required permissions for your agent type

From the Agents list in the Agentforce Studio app, open the agent you no longer want to receive file uploads.
If you’re viewing the agent in Canvas view, switch to Script view.
In your agent's config block, add the file_upload field and specify a mode value of either disabled or error.
- disabled—File uploads are turned off silently. If a user tries to attach a file, the upload fails and the conversation continues with no error message. No files are saved.
```
config:
    developer_name: "Support_Agent"
    agent_label: "Customer Support Agent"
    file_upload:
        mode: "disabled"
```
- error—File uploads are turned off. If a user tries to attach a file, the agent sends an error message. Use the optional message field to define an error message. No files are saved.
```
config:
    developer_name: "Support_Agent"
    agent_label: "Customer Support Agent"
    file_upload:
        mode: "error"
        message: "Sorry, I can't accept files. Is there something else I can help you with?"
```
Save your changes.
To confirm that file uploads have been turned off for your agent, start a preview conversation in Agentforce Builder and send a file.

Did this article solve your issue?

Let us know so we can improve!

Product Area