Trigger a manual fetch-and-ingest from an external transport

Lists every object matching the supplied transport coordinates and streams each into the trusted-content ingestion pipeline (dedup + outbox + match-trigger), returning a per-file outcome in fetch order. The tenant is resolved from the JWT and the context/source from the path — NEVER from the body. The body carries connection coordinates plus an OPAQUE credential reference. A transport-level fetch failure (the external endpoint is unreachable or rejects the credential) returns 503; per-file intake failures are reported in the response body without failing the batch.

POST /v1/imports/contexts/{contextId}/sources/{sourceId}/fetch

Trigger a manual fetch-and-ingest from an external transport

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/sources/{sourceId}/fetch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentialRef": "cred-handle-123",
  "host": "sftp.bank.example",
  "path": "outbound/returns",
  "port": 22,
  "connectOptions": {},
  "format": "br/cnab240/febraban-base",
  "glob": "*.ret",
  "kind": "sftp"
}
'

202

Example

{
  "files": [
    {
      "name": "statement-2025-06.ret",
      "transactionCount": 42,
      "error": "",
      "ingestionJobId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de ruta

contextId · string<uuid> · requerido

Context ID

sourceId · string<uuid> · requerido

Source ID

Cuerpo

application/json

credentialRef · string · requerido

Opaque stored-credential reference

Minimum string length: 1

Ejemplo:

"cred-handle-123"

host · string · requerido

Remote endpoint hostname or IP

Minimum string length: 1

Ejemplo:

"sftp.bank.example"

path · string · requerido

Remote directory to list/fetch from

Minimum string length: 1

Ejemplo:

"outbound/returns"

port · integer<int64> · requerido

Remote endpoint port

Rango requerido: 1 <= x <= 65535

Ejemplo:

22

connectOptions · object

Optional non-secret transport tuning (e.g. known_hosts, user, timeout_seconds)

Show child attributes

format · string

Fallback content-format hint applied when a fetched object declares none. Accepts the namespaced FormatDescriptor key (region/family/variant) or the legacy flat aliases (cnab240, cielo_edi, ...); both resolve through the same parser registry

Ejemplo:

"br/cnab240/febraban-base"

glob · string

Optional glob filter; empty fetches all

Ejemplo:

"*.ret"

kind · enum<string>

Transport kind selecting the adapter

Opciones disponibles: sftp, https, s3, imap

Ejemplo:

"sftp"

Respuesta

202

application/json

Accepted

files · object[] | null · requerido

Per-file outcomes of the fetch-and-ingest batch, in fetch order

Show child attributes