Connectors

Create or upgrade a synced link

Changed on

Standing promise: backfill now, then stay current (the sync sweeper re-runs synced links on a schedule). Direction both creates paired import/export links and defaults export to a CaseMark Output subfolder. Same body as /transfer minus run_mode. Upserts links by (connection_id, direction, remote, vault_id); existing once-links are upgraded in place with their ledger and cursor preserved. Downgrade or pause via PATCH /links/{id}.

post/connectors/v1/sync-link

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/connectors/v1/sync-link
  • Auth
    HTTP bearer

Headers

x-case-connector-subjectstring

Trusted server-to-server application-user assertion. Derive it from the authenticated application session, never browser input. Omit only for the legacy organization-scoped namespace.

Request body

direction'import' | 'export' | 'both' required
connection_idstring required
vault_idstring required
matter_idstring nullable

Response

Synced link created/upgraded; backfill or incremental run in progress

linksobject[]

Changes