Check a feed before adding it
Reads the first rows of a feed with the settings it would get and says how many would import, match nothing (enrich only) or be skipped, with the first skipped rows and why. Adds nothing. 422 `feed_unreadable` as for preview.
Reads the first rows of a feed with the settings it would get and says how many would import, match nothing (enrich only) or be skipped, with the first skipped rows and why. Adds nothing. 422 feed_unreadable as for preview.
apiKey writeAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: write
idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
1 <= length <= 255application/json- body
url*stringWhere the file is: a public http(s) URL
urilength <= 2000locale*|Every row’s locale; null when a column is mapped to locale
length <= 35mode*string"add_and_enrich""enrich_only"mapping*Column name → a field, ignore, or { "custom": "<key>" }
storeId*stringuuidOK
application/json- response
checked*integerimportable*integervariantOnly*integerfromFirstRow*integerunmatched*integerskipped*integerskippedRows*array<>curl -X POST 'https://api.postforge.dev/v1/feeds/check' \ -H 'Content-Type: application/json' \ -d '{ "url": "http://example.com", "locale": "string", "mode": "add_and_enrich", "mapping": { "property1": "id", "property2": "id" }, "storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c"}'{ "checked": 0, "importable": 0, "variantOnly": 0, "fromFirstRow": 0, "unmatched": 0, "skipped": 0, "skippedRows": [ { "row": 0, "id": "string", "reason": "string" } ]}