Releasesv0.1.0
Api referenceEndpointsAdmin

One sync run (instance admin, one tenant)

GET
/v1/admin/tenants/{tenant_id}/users/{id}/sync-runs/{run_id}

GET /v1/users/{id}/sync-runs/{run_id} (getSyncRun) for the tenant of tenant_id, read with an instance admin key: the same parameters and the same answer as the tenant's own key gets. Recorded in the caller's audit log and, actor admin, in the tenant's. See docs/admin-api.md.

Authorization

tenantKey
headerAuthorizationBearer <token>

Tenant API key, ohs_sk_ + 43 base62 characters.

Path Parameters

tenant_id*string

The id of a tenant; any other value is a 404.

Formatuuid
id*string
Formatuuid
run_id*integer
Formatint64

Header Parameters

Authorization*string

The tenant API key, as a bearer secret.

Response Body

The run.

application/json
  1. response

One pull of one connection. status is queued, running, retrying (the last attempt failed, see error; the next is at next_attempt_at), rate_limited (the provider asked to wait until next_attempt_at), succeeded, failed (attempts spent, or the grant was refused) or cancelled (the connection was disconnected). objects_stored counts the raw provider payloads stored; the records written from them are announced by data.written webhooks.

id*integer
Formatint64
provider*string
trigger*string
Value in"backfill""scheduled""notification""manual"
status*string
Value in"queued""running""retrying""rate_limited""succeeded""failed""cancelled"
data_type*|

Set when a notification named the one data type to pull.

window_start*string
Formatdate-time
window_end*string
Formatdate-time
attempts*integer

Failed attempts so far.

objects_stored*integer|null
error*string|null
created_at*string
Formatdate-time
started_at*|
Formatdate-time
finished_at*|
Formatdate-time
next_attempt_at*|
Formatdate-time
curl -X GET 'http://localhost:8080/v1/admin/tenants/497f6eca-6276-4993-bfeb-53cbbbba6f08/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/sync-runs/0' \  -H 'Authorization: Bearer ohs_sk_...'
{  "id": 0,  "provider": "string",  "trigger": "backfill",  "status": "queued",  "data_type": "string",  "window_start": "2019-08-24T14:15:22Z",  "window_end": "2019-08-24T14:15:22Z",  "attempts": 0,  "objects_stored": 0,  "error": "string",  "created_at": "2019-08-24T14:15:22Z",  "started_at": "2019-08-24T14:15:22Z",  "finished_at": "2019-08-24T14:15:22Z",  "next_attempt_at": "2019-08-24T14:15:22Z"}
Edit on GitHub