Imports

Import rows into a catalog

POST
/v1/catalogs/{id}/imports

Send parsed rows as JSON. Returns an import job; poll it for progress. Each row is matched, enriched and added to the catalog.

Scope: imports:write

Authorization

apiKey
headerAuthorizationBearer <ik_live_…>

An organisation API key from Settings → Organisation → API keys. Each operation names the one scope it needs — see https://developer.ingenee.ai/docs/authentication.

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

Any unique string. A retry with the same key and the same request gets the first answer back instead of running twice (kept 24 hours).

Lengthlength <= 255

Request Body

application/json
  1. body
filename?string

Name of the source file, shown on the import job.

Lengthlength <= 260
rows*array<>

One object per title, keyed by Ingenee field names (title, year, imdbId, releaseDate, synopsis …). See the Imports guide for the full list.

Items1 <= items <= 100000

Response Body

OK

application/json
  1. response
[key: string]?any
Example Request
curl -X POST 'https://dev.app.ingenee.ai/api/v1/catalogs/string/imports' \  -H 'Content-Type: application/json' \  -d '{  "rows": [    {      "property1": null,      "property2": null    }  ]}'
Example Response
{}