API endpointsBackfill requestsSubmit one or more backfill requests, each for one content type's history on one Connected Profile POST

Submit one or more backfill requests, each for one content type's history on one Connected Profile

POST
/v1/backfill-requests

Submit one or more backfill requests, each for one content type's history on one Connected Profile. Historical items are delivered as ordinary content.* events; nothing is stored. Validation is atomic across the submission and every item then runs independently. Requires an Idempotency-Key; one run per content type per profile may be in flight at a time.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Header Parameters

idempotency-key*string

A unique key for this request, scoped to the Organization and operation. Retrying with the same key and payload returns the first result instead of repeating the work; the same key with a different payload is refused with 409 conflict. Keys expire 24 hours after first use, and a request still in flight after 15 minutes releases its key.

Match\S
Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/backfill-requests" \  -H "idempotency-key: string" \  -H "Content-Type: application/json" \  -d '{    "items": [      {        "connectedProfileId": "cp_123",        "contentType": "instagram.media.items"      },      {        "connectedProfileId": "cp_123",        "contentType": "instagram.stories.items"      }    ],    "since": "2026-06-01T00:00:00Z",    "maxItems": 1000  }'
{  "backfillRequests": [    {      "backfillRequestId": "string",      "connectedProfileId": "string",      "contentType": "string",      "since": "2019-08-24T14:15:22Z",      "maxItems": 0,      "status": "pending",      "stopReason": "exhausted",      "emitted": 0,      "fetched": 0,      "skipped": 0,      "oldestEmittedAt": "2019-08-24T14:15:22Z",      "error": "string",      "startedAt": "2019-08-24T14:15:22Z",      "completedAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ]}
{  "error": {    "code": "validation_error",    "message": "string",    "meta": {      "property1": null,      "property2": null    }  }}

List the Organization's backfill requests, newest first, optionally narrowed to one Connected Profile and one status GET

List the Organization's backfill requests, newest first, optionally narrowed to one Connected Profile and one status.

Get one backfill request and its progress GET

Get one backfill request and its progress.