Skip to main content
Start a sync

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Path Parameters

id
string<uuid>
required

Body

application/json
date_from
string

First invoice date to read, inclusive.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_through
string

Last invoice date to read, inclusive.

Pattern: ^\d{4}-\d{2}-\d{2}$
scope
object

Omit to read the integration’s saved scope. When sent, it replaces the saved scope for this run: every dimension it leaves out reads everything instead of falling back to the saved value.

max_files
integer

Stop after this many new invoices.

Required range: x <= 100000

Response

The sync was admitted and is running.

id
string<uuid>
required

Also the workflow run id: progress, items and cancel use it.

integration_id
string<uuid>
required
trigger
enum<string>
required
Available options:
manual,
scheduled
mode
enum<string>
required

period reads a requested date range; incremental continues from the last sync.

Available options:
period,
incremental
period
object | null
required

Invoice dates read: from is inclusive, to is exclusive.

scope
object
required

The scope this run used, frozen when it started.

max_files
integer | null
required
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled
coverage
enum<string>
required

partial: the run ended without reading everything it was asked to (discovery stopped early, invoices were deferred, or it was cancelled). retryable says whether a retry can complete it.

Available options:
in_progress,
full,
partial
discovery
object
required

Finding the invoices to import; items then import them one by one.

items
object
required
invoices
object
required
retryable
boolean
required

POST …/retry would resume discovery or re-queue failed invoices.

retry_blocked_by
enum<string> | null
required
Available options:
superseded,
configuration_changed,
integration_disabled,
active_sync,
null
failure
object | null
required
created_by
object | null
required
created_at
string<date-time>
required
finished_at
string<date-time> | null
required