Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt

Use this file to discover all available pages before exploring further.

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}"
  }'

{
  "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

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}"
  }'

{
  "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}"

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

​
Validar credenciales

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}"

true

​
Listar archivos

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

[
  {
    "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" \

{
  "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.