Skip to main content
POST
Create a data source

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Corpo

application/json

JSON request payload.

configName
string
obrigatório

Stable business key referenced by templates; unique among live data sources.

Exemplo:

"midaz_onboarding"

databaseName
string
obrigatório

Database name.

Exemplo:

"onboarding"

host
string
obrigatório

Database host.

Exemplo:

"db.internal"

password
string
obrigatório

Write-only credential: encrypted at rest, never returned by any operation.

Exemplo:

"-"

port
integer<int64>
obrigatório

Database port.

Exemplo:

5432

type
string
obrigatório

Data source engine type: postgresql or mongodb.

Exemplo:

"postgresql"

username
string
obrigatório

Database username.

Exemplo:

"reporter_ro"

metadata
object

Free-form metadata.

options
string

MongoDB URI options string (e.g. authSource=admin). Not applicable to postgresql.

Exemplo:

"authSource=admin"

schemas
string[] | null

PostgreSQL schemas to expose; defaults to [public]. Not applicable to mongodb.

Exemplo:
sslCaBase64
string

MongoDB or PostgreSQL: standard Base64 of a PEM CA bundle. Mutually exclusive with an existing CA file; requires verified TLS (postgresql requires sslMode verify-ca or verify-full).

Exemplo:

""

sslMode
string

TLS mode: disable, require, verify-ca, or verify-full. Defaults to verify-full for PostgreSQL with sslCaBase64; otherwise defaults to require when omitted.

Exemplo:

"require"

Resposta

Created

builtIn
boolean

True for a data source the platform provides from the tenant's Lerian module databases; read-only, never registered

Exemplo:

false

configName
string

Stable business key referenced by templates

Exemplo:

"midaz_onboarding"

createdAt
string<date-time>

Creation timestamp in UTC

Exemplo:

"2026-01-01T00:00:00Z"

databaseName
string

Database name

Exemplo:

"onboarding"

host
string

Database host

Exemplo:

"db.internal"

id
string

Unique data source identifier

Exemplo:

"00000000-0000-0000-0000-000000000000"

lastConnection
object

Outcome of the most recent connectivity probe; absent means never probed, which is not the same as failed

metadata
object

Free-form metadata

options
string

MongoDB URI options string (e.g. authSource=admin); mongodb only

Exemplo:

"authSource=admin"

port
integer<int64>

Database port

Exemplo:

5432

schemas
string[] | null

PostgreSQL schemas to expose

Exemplo:
sslCaBase64
string

Base64-encoded PEM CA bundle for MongoDB or PostgreSQL; never a private key. PostgreSQL requires sslMode verify-ca or verify-full.

Exemplo:

""

sslMode
string

TLS mode: disable, require, verify-ca, or verify-full

Exemplo:

"require"

type
string

Data source engine type

Exemplo:

"postgresql"

updatedAt
string<date-time>

Most recent update timestamp in UTC

Exemplo:

"2026-01-01T00:00:00Z"

username
string

Database username

Exemplo:

"reporter_ro"