Skip to main content
GET
/
workspaces
/
{workspaceId}
/
sync-logs
Get all sync logs
curl --request GET \
  --url https://api.qontext.ai/workspaces/{workspaceId}/sync-logs \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "sync_123e4567-e89b-12d3-a456-426614174000",
    "ingestionPipelineId": "pipe_123e4567-e89b-12d3-a456-426614174000",
    "knowledgeGraphId": "kg_123e4567-e89b-12d3-a456-426614174000",
    "workspaceId": "ws_123e4567-e89b-12d3-a456-426614174000",
    "type": "full_sync",
    "status": "completed",
    "startedAt": "2021-01-01T00:00:00.000Z",
    "completedAt": "2021-01-01T00:00:00.000Z",
    "errorMessage": "Failed to connect to data source",
    "jobId": "job_123",
    "preparationMetadata": {
      "contacts": 1000,
      "deals": 500,
      "companies": 300
    },
    "totalRecordsToIngest": 1800,
    "recordsIngested": 450,
    "preparationCompletedAt": "2021-01-01T00:00:00.000Z",
    "minDate": "2021-01-01T00:00:00.000Z",
    "manualSyncData": {
      "manualSyncData": "manual_sync_data"
    },
    "correlationId": "4fd0b6c2a4d1e0f8a2b9c3d4e5f60718",
    "createdAt": "2021-01-01T00:00:00.000Z",
    "updatedAt": "2021-01-01T00:00:00.000Z"
  }
]

Authorizations

​
X-API-Key
string
header
required

API key for the Qontext API

Path Parameters

​
workspaceId
string
required

The unique identifier of the workspace the sync log belongs to.

Example:

"ws_123e4567-e89b-12d3-a456-426614174000"

Response

Sync logs successfully fetched

​
id
object
required

Unique identifier for the sync log

Example:

"sync_123e4567-e89b-12d3-a456-426614174000"

​
ingestionPipelineId
object
required

ID of the ingestion pipeline this sync log belongs to

Example:

"pipe_123e4567-e89b-12d3-a456-426614174000"

​
knowledgeGraphId
string
required

ID of the knowledge graph this sync log relates to

Example:

"kg_123e4567-e89b-12d3-a456-426614174000"

​
workspaceId
string
required

ID of the workspace this sync log belongs to

Example:

"ws_123e4567-e89b-12d3-a456-426614174000"

​
type
enum<string>
required

Type of sync operation

Available options:
full_sync,
live_sync,
incremental_sync,
manual_sync
Example:

"full_sync"

​
status
enum<string>
required

Status of the sync operation

Available options:
pending,
preparing,
data_fetching,
ingesting,
completed,
failed,
stopped
Example:

"completed"

​
startedAt
object
required

When the sync operation started

Example:

"2021-01-01T00:00:00.000Z"

​
completedAt
object
required

When the sync operation completed

Example:

"2021-01-01T00:00:00.000Z"

​
errorMessage
object
required

Error message if the sync operation failed

Example:

"Failed to connect to data source"

​
jobId
object
required

ID of the background job handling this sync

Example:

"job_123"

​
preparationMetadata
object
required

Preparation metadata including record type counts

Example:
{
  "contacts": 1000,
  "deals": 500,
  "companies": 300
}
​
totalRecordsToIngest
object
required

Total number of records that need to be ingested

Example:

1800

​
recordsIngested
object
required

Number of records successfully ingested

Example:

450

​
preparationCompletedAt
object
required

When the preparation step was completed

Example:

"2021-01-01T00:00:00.000Z"

​
minDate
object
required

The minimum date for the sync operation. Only records changed after this date will be synced.

Example:

"2021-01-01T00:00:00.000Z"

​
manualSyncData
object
required

Data for manual sync

Example:
{ "manualSyncData": "manual_sync_data" }
​
correlationId
object
required

Correlation ID (W3C trace-id) for end-to-end tracing

Example:

"4fd0b6c2a4d1e0f8a2b9c3d4e5f60718"

​
createdAt
object
required

The date and time the sync log was created

Example:

"2021-01-01T00:00:00.000Z"

​
updatedAt
object
required

The date and time the sync log was last updated

Example:

"2021-01-01T00:00:00.000Z"

⌘I