List integration sync runs

curl --request GET \
  --url https://api.neoagent.io/public-api/integrations/{name}/sync-runs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "activities": [
        {
          "activity_label": "<string>",
          "failures": [
            {
              "error_message": "<string>",
              "parent_label": "<string>",
              "reason": "<string>",
              "resource_label": "<string>"
            }
          ],
          "synced_count": 123,
          "total_count": 123
        }
      ],
      "dashboard_message": "<string>",
      "error": "<string>",
      "finished_at": "2023-11-07T05:31:56Z",
      "run_id": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "temporal_run_id": "<string>",
      "temporal_workflow_id": "<string>"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Integrations

List integration sync runs

Sync history for one integration on the caller’s tenant — per-activity counts and per-resource failures from pipeline_runs.sync_details. Use when an MSP asks “I created X in PSA, where is it?”: a recent successful run with empty failures means watermark-or-cadence latency; a run with failures on a specific resource means a real per-type problem. Default window is the last 30 days; max window is 30 days. Returns 404 unknown_integration for an unrecognised name, integration_not_connected if the tenant doesn’t have it configured, and integration_does_not_sync for connected integrations that don’t run scheduled syncs.

GET

public-api

integrations

{name}

sync-runs

List integration sync runs

curl --request GET \
  --url https://api.neoagent.io/public-api/integrations/{name}/sync-runs \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "activities": [
        {
          "activity_label": "<string>",
          "failures": [
            {
              "error_message": "<string>",
              "parent_label": "<string>",
              "reason": "<string>",
              "resource_label": "<string>"
            }
          ],
          "synced_count": 123,
          "total_count": 123
        }
      ],
      "dashboard_message": "<string>",
      "error": "<string>",
      "finished_at": "2023-11-07T05:31:56Z",
      "run_id": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "temporal_run_id": "<string>",
      "temporal_workflow_id": "<string>"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token> where <token> is either a neo_sk_<env>_<secret> API key (service account) or a Microsoft Entra ID access token (dashboard user).

Path Parameters

name

string

required

Query Parameters

since

string

ISO-8601 lower bound on run start time. Defaults to 30 days before until.

until

string

ISO-8601 upper bound on run start time. Defaults to now.

page_size

integer

Items per page (1-200, default 50).

cursor

string

Opaque pagination cursor from a previous response's meta.pagination.next_cursor.

Response

Success.

data

SyncRun · object[]

required

Show child attributes