> ## Documentation Index > Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml https://api.neoagent.io/public-api/openapi.json get /public-api/integrations/{name}/sync-runs openapi: 3.1.0 info: description: >- Neo's public contract for the dashboard ChatAgent, partner integrations, and MSP automation. Every response is wrapped in a `{data, meta}` envelope; errors use `{error: {code, message, details?}, meta: {request_id}}`. Authenticate with a `Bearer neo_sk__` API key (service account) or a Microsoft Entra ID JWT (dashboard user). Signed-URL endpoints (end-user feedback links) take a `signature` query parameter instead. title: Neo Public API version: 1.0.0 servers: - url: https://api.neoagent.io security: [] tags: - description: Service metadata — health, OpenAPI. name: Meta - description: Agents and workflows — read, version history, delete, stats. name: Agents - description: Agent/workflow execution history, sub-resources, retry/cancel. name: Executions - description: PSA webhook events and their workflow-match results. name: Callbacks - description: Technician-in-the-loop approval requests. name: TIL requests - description: RMM script executions triggered by agents. name: RMM scripts - description: Dispatch-agent field-update decisions. name: Dispatch - description: The authenticated tenant. name: Tenant - description: Agent-builder schema catalogs (raw JSON payloads). name: Schemas - description: Escalate to the Neo team (HubSpot ticket). name: Escalation - description: Tenant settings. name: Settings - description: Tenant API-key management (dashboard JWT only). name: API keys - description: End-user feedback links (signed-URL auth). name: Feedback - description: End-client companies (CRUD + bulk-update). name: End companies - description: Channels — bind a CONVERSATIONAL agent to a transport (Teams). name: Channels - description: PSA/RMM/M365 integration status and connection management. name: Integrations - description: Technician roster (controls TIL routing and paging). name: Technicians - description: Future runs queued for TRIGGERED agents. name: Scheduled work - description: Subscription state and customer-facing credit usage (no provider $). name: Billing - description: Inbox messages and announcements. name: Inbox & Comms - description: Tenant-authored agent skills (CRUD) and the built-in skill catalog. name: Skills paths: /public-api/integrations/{name}/sync-runs: get: tags: - Integrations summary: List integration sync runs description: >- 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. operationId: public_api.sync_runs_list_get parameters: - in: path name: name required: true schema: type: string - description: >- ISO-8601 lower bound on run start time. Defaults to 30 days before `until`. in: query name: since required: false schema: type: string - description: ISO-8601 upper bound on run start time. Defaults to now. in: query name: until required: false schema: type: string - description: Items per page (1-200, default 50). in: query name: page_size required: false schema: type: integer - description: >- Opaque pagination cursor from a previous response's `meta.pagination.next_cursor`. in: query name: cursor required: false schema: type: string responses: '200': content: application/json: schema: properties: data: items: $ref: '#/components/schemas/SyncRun' type: array meta: $ref: '#/components/schemas/SuccessMeta' required: - data - meta type: object description: Success. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Bad request — malformed input. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Unauthenticated — missing or invalid credentials. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Forbidden — authenticated but not allowed. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Not found. '409': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Conflict — the resource is in a state that blocks this operation. '422': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Request validation failed. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limited — see Retry-After. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. security: - bearerAuth: [] components: schemas: SyncRun: description: |- One row from `pipeline_runs`. Honest shape: we surface what's stored, not a speculative per-entity-type cursor view (we don't persist that). properties: activities: items: $ref: '#/components/schemas/SyncActivity' title: Activities type: array dashboard_message: anyOf: - type: string - type: 'null' title: Dashboard Message error: anyOf: - type: string - type: 'null' title: Error finished_at: anyOf: - format: date-time type: string - type: 'null' title: Finished At run_id: title: Run Id type: string started_at: anyOf: - format: date-time type: string - type: 'null' title: Started At status: $ref: '#/components/schemas/SimpleStatus' temporal_run_id: anyOf: - type: string - type: 'null' title: Temporal Run Id temporal_workflow_id: anyOf: - type: string - type: 'null' title: Temporal Workflow Id required: - run_id - temporal_run_id - temporal_workflow_id - status - started_at - finished_at - error - dashboard_message - activities title: SyncRun type: object SuccessMeta: properties: pagination: $ref: '#/components/schemas/Pagination' request_id: format: uuid type: string timings_ms: additionalProperties: type: number type: object warnings: description: >- Non-fatal warnings about the created/updated resource (e.g. an unhealthy PSA callback). items: type: string type: array required: - request_id - timings_ms type: object ErrorEnvelope: properties: error: properties: code: description: Stable machine-readable error code. type: string details: additionalProperties: true type: object message: type: string required: - code - message type: object meta: properties: request_id: format: uuid type: - string - 'null' type: object required: - error - meta type: object SyncActivity: description: |- One activity inside a sync run (e.g. "PSA Metadata", "PSA Contacts"). `synced_count` is how many records the activity actually upserted out of `total_count` candidates; `failures[]` is the per-resource problem list. properties: activity_label: title: Activity Label type: string failures: items: $ref: '#/components/schemas/SyncEntityFailure' title: Failures type: array synced_count: title: Synced Count type: integer total_count: title: Total Count type: integer required: - activity_label - synced_count - total_count - failures title: SyncActivity type: object SimpleStatus: enum: - RUNNING - SUCCESS - FAILURE - SKIPPED title: SimpleStatus type: string Pagination: properties: has_more: type: boolean next_cursor: type: - string - 'null' required: - next_cursor - has_more type: object SyncEntityFailure: description: |- One per-entity-type failure inside an activity (e.g. "Ticket Types" permission-denied on board 444). Sourced verbatim from `sync_details`. properties: error_message: title: Error Message type: string parent_label: anyOf: - type: string - type: 'null' title: Parent Label reason: title: Reason type: string resource_label: title: Resource Label type: string required: - resource_label - parent_label - reason - error_message title: SyncEntityFailure type: object securitySchemes: bearerAuth: description: >- `Authorization: Bearer ` where `` is either a `neo_sk__` API key (service account) or a Microsoft Entra ID access token (dashboard user). scheme: bearer type: http ````