Skip to main content
POST
`POST /orgs/{org_id}/connectors/{connector_id}/local-config`

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
connector_id
string
required

Body

application/json
connections
object

connection_ref → connection object, same shape as the connections map in the connector's config.json (e.g. { "kind": "postgres", "dsn": "...", "query": "read" }). When present, replaces the connector's whole local connections map. Absent = keep local.

filesystems
object

filesystem_ref → filesystem root object, same shape as the filesystems map in config.json (e.g. { "path": "/srv/exports" }). When present, replaces the connector's whole local filesystems map. Absent = keep local.

Response

Config push dispatched

connections
boolean
required

Which maps were included in the push.

dispatched
boolean
required

Always true on a 202 — the connector validates/acks asynchronously over the channel and restarts to apply; watch the fleet listing for it to reconnect.

filesystems
boolean
required