List agent files
List agent files
List the files your agents can send to leads, with their handles and sending instructions, and optionally whether one task can send each file.
GET
List agent files
These are the files your agents send to leads, such as a brochure, a price list, or a photo. In the app they appear in Files to send, in each agent’s right pane. See Knowledge base, files and product catalogs.
In the API an agent is a
master_workflow and a task is a workflow. Availability is saved per task, so workflow_id is a task ID.
How agent files work
Check one task
Addworkflow_id to get enabled for that task: true when the task can send the file, false when the file was removed from it. Without workflow_id, enabled is null.
Before you start
- MCP keys need
workflows:readto read andworkflows:writeto make changes. Full-access API keys need nothing else. - To stop some tasks from sending a file without deleting it, use Set availability.
- Errors return
errorand a readablemessage. Map them to your own copy.
Authorizations
API key for authentication. Keys are prefixed with nxr_live_.
Query Parameters
Task ID (workflow in the API). Adds enabled for this task. A malformed ID returns 400, and a task outside this account returns 404.
Last modified on September 29, 2026