List Executions

GET

https://app.polytomic.com/api/syncs/:sync_id/executions

GET

/api/syncs/:sync_id/executions

curl https://app.polytomic.com/api/syncs/248df4b7-aa70-47b8-a036-33ac447e668d/executions \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "completed_at": "2024-01-01T00:00:00Z",
      "counts": {
        "delete": 42,
        "error": 5,
        "insert": 80,
        "total": 100,
        "update": 15,
        "upserts": 10,
        "warnings": 10
      },
      "created_at": "2024-01-01T00:00:00Z",
      "errors": [
        "something went wrong"
      ],
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "started_at": "2024-01-01T00:00:00Z",
      "status": "created",
      "type": "scheduled",
      "version": "rel2026.08.05.06~1a2b3c4"
    }
  ],
  "pagination": {
    "next_page_token": "AmkYh8v0jR5B3kls2Qcc9y8MjrPmvR4CvaK7H0F4rEwqvg76K=="
  }
}

Lists executions for a model sync.

Results are ordered by start time descending. If more results are available, the response includes pagination.next_page_token; pass that token back unchanged to continue paging.

The token is opaque. Do not construct or edit it yourself.

For full details about a specific execution — including record counts and error summaries — use GET /api/syncs/{sync_id}/executions/{id}.

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

sync_idstringRequiredformat: "uuid"

Model sync ID

Query parameters

page_tokenstringOptional

Token from the previous page

only_completedbooleanOptional

Return only completed executions.

ascendingbooleanOptional

Return executions oldest first.

Response

datalist of objects or nullOptional

Executions on this page

paginationobjectOptional

Pagination details for the next page

Errors

404

Not Found Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors