Skip to content
Last updated

List, trigger, and cancel sync and reset jobs.

List jobs

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/jobs

Returns jobs with optional filtering by connection, type, status, and date range.

Query Parameters

connection_id string optional

Filter by connection ID.

job_type string optional

Filter by type: sync or reset.

status string optional

Filter by status (e.g., running, succeeded, failed).

limit integer optional

Maximum number of results.

offset integer optional

Pagination offset.

order_by string optional

Sort order field.


Get job

GEThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/jobs/{job_id}

Retrieve a single job by ID.

Path Parameters

job_id string required

The job ID.


Trigger job

POSThttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/jobs

Start a new sync or reset job.

Request Body

connection_id string required

Connection to trigger the job for.

job_type string required

Job type: sync or reset.


Cancel job

DELETEhttps://api.aitronos.com/v1/organizations/{organization_id}/knowledge/connectors/jobs/{job_id}

Cancel a running job. Returns 204 No Content on success.


Returns

A job object containing job_id, status, job_type, start_time, connection_id, bytes_synced, rows_synced, and duration.

cURL
curl "https://api.aitronos.com/v1/organizations/org_xyz789/knowledge/connectors/jobs?connection_id=conn_abc123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"