> ## 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.

# Integración Filesystem

> Sincroniza archivos desde un sistema de archivos compartido al espacio de trabajo.

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](/es/operator-manual/knowledge-base/file-system).

## Solicitud básica y respuesta

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

```bash theme={null}
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}"
  }'
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  {
    "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"
  }
  ```
</Accordion>

## Actualizar credenciales

<Accordion title="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.        |
</Accordion>

```bash theme={null}
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}"
  }'
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  {
    "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"
  }
  ```
</Accordion>

## Obtener configuración

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

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  {
    "path": "/mnt/shared/support"
  }
  ```
</Accordion>

## Validar credenciales

<Accordion title="Parametros del endpoint">
  | Tipo  | Nombre     | Obligatorio | Notas                               |
  | ----- | ---------- | ----------- | ----------------------------------- |
  | Query | `username` | Si          | Usuario de Filesystem a validar.    |
  | Query | `password` | Si          | Contraseña de Filesystem a validar. |
</Accordion>

```bash theme={null}
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}"
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  true
  ```
</Accordion>

## Listar archivos

<Accordion title="Parametros del endpoint">
  | Tipo  | Nombre          | Obligatorio | Notas                                       |
  | ----- | --------------- | ----------- | ------------------------------------------- |
  | Query | `integrationId` | Si          | Identificador de la integración Filesystem. |
</Accordion>

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

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  [
    {
      "path": "/mnt/shared/support/weekly-brief.pdf",
      "name": "weekly-brief.pdf",
      "size": 287104,
      "updated_at": "2026-02-07T19:22:10Z"
    }
  ]
  ```
</Accordion>

## Iniciar sincronización

```bash theme={null}
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" \
```

<Accordion title="Ejemplo de respuesta">
  ```json theme={null}
  {
    "type": "sync_started",
    "current_artifact_count": 12,
    "integration_item_count": 48
  }
  ```
</Accordion>

## Errores y casos límite

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