Relationship Intelligence

Disconnect

Disconnect posts no request body. The stored source is disconnected, backfill returns to idle, completeness is disconnected, and sync lag is cleared. Credential revocation stays on the connector path shown on the source card.

post/v1/relationship-sources/{source}/{sourceAccountId}/disconnect

Request

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

Path parameters

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

Example:google

Beta source provider.

sourceAccountIdstring required

Example:me@company.com

Provider account id.

Response

Disconnected source.

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 operation changes recorded.