Integración Filesystem

La integración de Filesystem conecta un directorio compartido con el espacio de trabajo. Habilita el conector primero en la guía del operador: Configuración de Filesystem.

Solicitud básica y respuesta

Crea una integración de Filesystem con POST /api/v1/app/integration/filesystem.

curl -X POST "https://{BASE_URL}/api/v1/app/integration/filesystem" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{file_system_username}",
    "password": "{file_system_password}"
  }'

Ejemplo de respuesta

{
  "id": "fs_9f8e7d6c5b4a3c2d",
  "user_id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "type": "FileSystem",
  "created_at": "2026-02-08T14:10:00Z",
  "updated_at": "2026-02-08T14:10:00Z"
}

Actualizar credenciales

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Path	`integrationID`	Si	Identificador de la integración.
Body	`username`	Si	Usuario de Filesystem.
Body	`password`	Si	Contraseña de Filesystem.

curl -X POST "https://{BASE_URL}/api/v1/app/integration/filesystem/{integrationID}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{file_system_username}",
    "password": "{file_system_password}"
  }'

Ejemplo de respuesta

{
  "id": "fs_9f8e7d6c5b4a3c2d",
  "user_id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "type": "FileSystem",
  "created_at": "2026-02-08T14:10:00Z",
  "updated_at": "2026-02-08T15:02:00Z"
}

Obtener configuración

curl "https://{BASE_URL}/api/v1/app/integration/filesystem/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "path": "/mnt/shared/support"
}

Validar credenciales

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Query	`username`	Si	Usuario de Filesystem a validar.
Query	`password`	Si	Contraseña de Filesystem a validar.

curl "https://{BASE_URL}/api/v1/app/integration/filesystem/validate?username={file_system_username}&password={file_system_password}" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Ejemplo de respuesta

true

Listar archivos

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Query	`integrationId`	Si	Identificador de la integración Filesystem.

curl "https://{BASE_URL}/api/v1/app/integration/filesystem/files?integrationId={integrationID}" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Ejemplo de respuesta

[
  {
    "path": "/mnt/shared/support/weekly-brief.pdf",
    "name": "weekly-brief.pdf",
    "size": 287104,
    "updated_at": "2026-02-07T19:22:10Z"
  }
]

Iniciar sincronización

curl -X POST "https://{BASE_URL}/api/v1/app/integration/filesystem/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \

Ejemplo de respuesta

{
  "type": "sync_started",
  "current_artifact_count": 12,
  "integration_item_count": 48
}

Errores y casos límite

403: conector no habilitado o sin permisos.
400: credenciales inválidas.
404: integración no encontrada.

Primeros pasos

Construye con Zylon

Coding Agents

Integración Filesystem

Solicitud básica y respuesta

Actualizar credenciales

Obtener configuración

Validar credenciales

Listar archivos

Iniciar sincronización

Errores y casos límite

​Solicitud básica y respuesta

​Actualizar credenciales

​Obtener configuración

​Validar credenciales

​Listar archivos

​Iniciar sincronización

​Errores y casos límite

Solicitud básica y respuesta

Actualizar credenciales

Obtener configuración

Validar credenciales

Listar archivos

Iniciar sincronización

Errores y casos límite