Sign in

v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
connectors

`POST /orgs/{org_id}/connectors/{connector_id}/local-config`

Push replacement connections/filesystems maps to a connector box.

post/orgs/{org_id}/connectors/{connector_id}/local-config

Path parameters

org_idstring required
connector_idstring required

Request body

connectionsobject

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.

filesystemsobject

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

connectionsboolean required

Which maps were included in the push.

dispatchedboolean 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.

filesystemsboolean required