Guide

Batch processing

Submit large catalogs asynchronously and poll for completion.

  1. Send a newline-delimited JSON payload to POST /v1/listings/batch.
  2. Capture the returned job_id.
  3. Poll GET /v1/jobs/{job_id} until status is succeeded, then fetch results.
Batch example
curl -X POST https://api.hermes.run/v1/listings/batch \
  -H "Authorization: Bearer <api_key>" \
  --data-binary "@catalog.ndjson"