Skip to main content
POST
Trigger a manual fetch-and-ingest from an external transport

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

contextId
string<uuid>
obrigatório

Context ID

sourceId
string<uuid>
obrigatório

Source ID

Corpo

application/json
credentialRef
string
obrigatório

Opaque stored-credential reference (not a secret)

Minimum string length: 1
Exemplo:

"cred-handle-123"

host
string
obrigatório

Remote endpoint hostname or IP

Minimum string length: 1
Exemplo:

"sftp.bank.example"

path
string
obrigatório

Remote directory to list/fetch from

Minimum string length: 1
Exemplo:

"outbound/returns"

port
integer<int64>
obrigatório

Remote endpoint port

Intervalo obrigatório: 1 <= x <= 65535
Exemplo:

22

connectOptions
object

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

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

Exemplo:

"br/cnab240/febraban-base"

glob
string

Optional glob filter; empty fetches all

Exemplo:

"*.ret"

kind
enum<string>

Transport kind selecting the adapter

Opções disponíveis:
sftp,
https,
s3,
imap
Exemplo:

"sftp"

Resposta

Accepted

files
object[] | null
obrigatório

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