Skip to main content
POST
Create a data source

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json

JSON request payload.

configName
string
requerido

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

Ejemplo:

"midaz_onboarding"

databaseName
string
requerido

Database name.

Ejemplo:

"onboarding"

host
string
requerido

Database host.

Ejemplo:

"db.internal"

password
string
requerido

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

Ejemplo:

"-"

port
integer<int64>
requerido

Database port.

Ejemplo:

5432

type
string
requerido

Data source engine type: postgresql or mongodb.

Ejemplo:

"postgresql"

username
string
requerido

Database username.

Ejemplo:

"reporter_ro"

metadata
object

Free-form metadata.

options
string

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

Ejemplo:

"authSource=admin"

schemas
string[] | null

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

Ejemplo:
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).

Ejemplo:

""

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.

Ejemplo:

"require"

Respuesta

Created

builtIn
boolean

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

Ejemplo:

false

configName
string

Stable business key referenced by templates

Ejemplo:

"midaz_onboarding"

createdAt
string<date-time>

Creation timestamp in UTC

Ejemplo:

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

databaseName
string

Database name

Ejemplo:

"onboarding"

host
string

Database host

Ejemplo:

"db.internal"

id
string

Unique data source identifier

Ejemplo:

"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

Ejemplo:

"authSource=admin"

port
integer<int64>

Database port

Ejemplo:

5432

schemas
string[] | null

PostgreSQL schemas to expose

Ejemplo:
sslCaBase64
string

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

Ejemplo:

""

sslMode
string

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

Ejemplo:

"require"

type
string

Data source engine type

Ejemplo:

"postgresql"

updatedAt
string<date-time>

Most recent update timestamp in UTC

Ejemplo:

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

username
string

Database username

Ejemplo:

"reporter_ro"