Begin Batch

Download this manual as a PDF file

The Begin Batch API is called to begin a new batch upload. It is called as the first step in performing a batch upload. See the Usage page for more information on batch uploads.

Method URL POST http://<zapi_url>:<zapi_port>/api/v2/batch/
HTTP Method POST
Content Type application/json
Required Headers Authorization (set to ZAPI token)

Request Arguments

Optional Arguments Data Type How To Use
processing_method string Set to delay or opportunistic
retention_hours retention_hours Minimum time to retain batch status after processing completes, in hours.
batch_id string Optional user specified batch Id. Must be unique.

Response Payload

Optional Arguments Data Type How To Use
batch_id string Upload id, use as ze_batch_id.

Example Request Payload

{
  "processing_method": "delay",
  "retention_hours" : 8
}

Example Response Payload

{
     "batch_id": "b1cc71aef9989ead80012ac"
}