Managing connections

These commands work for every provider, however it was connected.

List and inspect

divinci connectors list                          # every connection in the workspace
divinci connectors status wordpress              # one provider
divinci connectors stats                         # counts across all connectors

list shows each connection's provider, status, recurrence, last sync and source URL. status adds the tracked file count and the connection id you need for the sync commands.

Run and track a sync

divinci connectors sync <connectionId>          # run one now
divinci connectors sync-status <connectionId>   # last 10 jobs, with item counts and errors
divinci connectors sync-cancel <connectionId>   # stop everything pending or running

If a sync job is already running you get a 409 with its job id. Jobs that have been active for more than a couple of minutes with nothing behind them are auto-cancelled so a crashed run cannot wedge the connection forever.

Change a schedule

divinci connectors settings wordpress                       # show
divinci connectors settings wordpress --auto-sync on --cadence 1440
divinci connectors settings wordpress --auto-sync off

Cadence is in minutes with a 15-minute floor.

Disconnect

divinci connectors disconnect wordpress

For OAuth providers this also revokes the token at the provider, on a best-effort basis — a failure there still marks the connection revoked here.

Every command takes `--workspace`

All of them default to your active workspace and accept --workspace <id> to target another.

The same surface elsewhere

| Surface | How | | --- | --- | | REST | /api/v1/connectors/*, with an API key carrying connector:read / connector:write | | MCP | connector_list, connector_status, connector_sync, connector_sync_status, connector_sync_cancel, connector_disconnect, connector_stats | | Web app | Workspace → Setup → Connectors |