Relationship Intelligence

Resync a source

Retry sync, Refresh now, and Resync post the connected account and queue a fresh read. The stored answer marks that account backfilling, with the read queued and completeness rebuilding.

post/v1/relationship-sources/{source}/resync

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/relationship-sources/{source}/resync
Auth: HTTP bearer

Path parameters

source'google' | 'slack' | 'hubspot' required

Example:google

Beta source provider.

Request body

sourceAccountIdstring required

Provider account id.

Example request

{
  "sourceAccountId": "owner@example.com"
}

Response

Queued source lifecycle.

authorizationStartedAtstring date-time nullable

Authorization start.

authorizedAtstring date-time nullable

Authorization completion.

backfillCompletedinteger required

Accepted backfill records.

backfillCompletedAtstring date-time nullable

Backfill completion.

Backfill phase.

backfillTotalinteger required

Known backfill total, zero when unknown.

completeness'complete' | 'partial' | 'stale' | 'rebuilding' | 'disconnected' required

Impact on relationship completeness.

connectionIdstring uuid required

Stable source connection id.

consentingActorIdstring uuid

User who connected this source.

disconnectedAtstring date-time nullable

User disconnect time.

errorCodestring

Categorical safe error code.

expectedCadenceSecondsinteger required

Expected live-sync cadence.

grantedScopesstring[] required

Currently granted scopes.

lagSecondsinteger required

Calculated sync lag.

lastErrorstring

Bounded, user-safe error summary.

lastFailedSyncAtstring date-time nullable

Most recent failed sync.

lastObservationAtstring date-time nullable

Newest accepted observation.

lastProviderEventAtstring date-time nullable

Newest provider event observed.

lastSuccessAtstring date-time nullable

Most recent successful sync.

lastSyncAtstring date-time nullable

Most recent sync attempt.

missingScopesstring[] required

Missing or revoked required scopes.

nextRetryAtstring date-time nullable

Next retry.

requiredScopesstring[] required

Scopes required by enabled capabilities.

retryCountinteger required

Bounded retry count.

revokedAtstring date-time nullable

Provider revocation time.

source'google' | 'slack' | 'hubspot' required

Source provider.

sourceAccountIdstring required

Provider account or workspace id.

Connection lifecycle.

syncStartedAtstring date-time nullable

Backfill start.

Example response

{
  "authorizationStartedAt": "2026-07-31T13:00:00Z",
  "authorizedAt": "2026-07-31T13:01:00Z",
  "backfillCompleted": 250,
  "backfillCompletedAt": "2026-07-31T13:10:00Z",
  "backfillPhase": "live",
  "backfillTotal": 1000,
  "completeness": "partial",
  "connectionId": "6b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "consentingActorId": "a8dfa9b6-a7b2-46ea-982c-622a914c00e5",
  "disconnectedAt": "2026-07-31T14:00:00Z",
  "errorCode": "rate_limited",
  "expectedCadenceSeconds": 900,
  "grantedScopes": [
    "https://www.googleapis.com/auth/gmail.readonly"
  ],
  "lagSeconds": 42,
  "lastError": "Provider synchronization is delayed.",
  "lastFailedSyncAt": "2026-07-31T14:00:00Z",
  "lastObservationAt": "2026-07-31T13:58:00Z",
  "lastProviderEventAt": "2026-07-31T13:58:00Z",
  "lastSuccessAt": "2026-07-31T14:00:00Z",
  "lastSyncAt": "2026-07-31T14:00:00Z",
  "missingScopes": [
    "https://www.googleapis.com/auth/gmail.send"
  ],
  "nextRetryAt": "2026-07-31T14:05:00Z",
  "requiredScopes": [
    "https://www.googleapis.com/auth/gmail.readonly"
  ],
  "retryCount": 2,
  "revokedAt": "2026-07-31T14:00:00Z",
  "source": "google",
  "sourceAccountId": "me@company.com",
  "status": "live",
  "syncStartedAt": "2026-07-31T13:01:00Z"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.