Skip to main content
POST
/
batches
Receive one batch per HTTP request
curl --request POST \
  --url https://destination.example.com/batches \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "records": [
    {}
  ],
  "format": "json",
  "path": "<string>",
  "presigned_url": "<string>"
}
'
{
  "status": "accepted",
  "message": "Accepted for processing."
}

Authorizations

X-API-KEY
string
header
required

Body

application/json

For direct JSON batches, Prequel sends records inline. For file-based formats, Prequel sends a path and presigned URL.

records
object[]
format
enum<string>
Available options:
json,
csv,
parquet,
iceberg
path
string

Object storage path for file-based batch delivery.

presigned_url
string<uri>

Presigned URL to fetch the file or manifest.

Response

Accepted

status
string
required
Example:

"accepted"

message
string
Example:

"Accepted for processing."