v1

latestOpenAPI 3.1.02026-07-2616636641.7 KB

Create Ingest URL

post/v1/itemdb/ingest-url

Request body

folderstring required

The folder or directory where the source file should be uploaded. When using with Kevel Catalog, this is generally products or categories.

filenamestring required

The name of the file that will be uploaded to the returned URL. This must include a file type extension (eg products.ndjson.gz). Note: Kevel will automatically prepend a datetime string to the provided file name.

Response

200

urlstring

statusstring

Example response

{
  "url": "https://kevel-prod-itemdb-ingest-default.s3.amazonaws.com/99999/products/incoming/2024-04-12T20%3A02%3A18.425674978-products.ndjson?x-amz-security-token=xxx&AWSAccessKeyId=xxx&Expires=1712955738&Signature=xxx",
  "status": "https://api.kevel.co/v1/itemdb/ingest-status?folder=products&file=2024-04-12T20%3A02%3A18.425674978-products.ndjson"
}