Skip to main content
GET
List agent files
Son los archivos que tus agentes les envían a los leads, como un folleto, una lista de precios o una foto. En la app aparecen en Archivos para enviar, en el panel derecho de cada agente. Consulta Base de conocimiento, archivos y catálogos de productos. En la API, un agente es un master_workflow y una tarea es un workflow. La disponibilidad se guarda por tarea, así que workflow_id es el ID de una tarea.

Cómo funcionan los archivos del agente

Revisa una tarea

Agrega workflow_id para recibir enabled de esa tarea: true cuando la tarea puede enviar el archivo y false cuando se quitó de ella. Sin workflow_id, enabled es null.

Antes de empezar

  • Las claves MCP necesitan workflows:read para leer y workflows:write para hacer cambios. Las claves de API con acceso completo no necesitan nada más.
  • Para que algunas tareas dejen de enviar un archivo sin eliminarlo, usa Cambiar disponibilidad.
  • Los errores devuelven error y un message legible. Tradúcelos a tu propio mensaje.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de consulta

workflow_id
string<uuid>

Task ID (workflow in the API). Adds enabled for this task. A malformed ID returns 400, and a task outside this account returns 404.

Respuesta

Files of the account.

success
enum<boolean>
requerido
Opciones disponibles:
true
files
object[]
requerido
Última modificación el 29 de septiembre de 2026