Create ZIP

POST /api/zip-create

Pack one or more files into a ZIP archive over HTTP. Optional comma-separated filenames, configurable compression level. Returns the archive as binary or base64.

Packs the supplied files into a single ZIP archive and returns it. Options: - `files`: one or more files. Order matters — `names` is matched by index. - `names` (optional): comma-separated filenames, indexed against `files`. If missing or short, unspecified entries fall back to `file-0.bin`, `file-1.bin`, and so on. - `level` (optional, default 6): compression level. `0` stores the files without compression (fastest, largest); `9` is max compression. Output is the ZIP bytes (Content-Type `application/zip`) or, if the caller prefers, a JSON envelope with the archive as base64.

Inputs

Name	Type	Default	Description
files*	file	—	One or more files to include. Bytes are taken in the order supplied; pair with `names` for stable filenames.
names	string	—	Comma-separated filenames, parallel-indexed with `files`. Missing entries fall back to `file-{index}.bin`.
level	number (0…9)	6	DEFLATE compression level (0 = stored / no compression, 9 = max).

Response

Modes: binary, json. Cache: yes (24h TTL).

Code samples

Built from the two-files example.

# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/zip-create/greetings.txt
FILES_0_=$(base64 -w0 < greetings.txt)
# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/zip-create/readme.md
FILES_1_=$(base64 -w0 < readme.md)

curl -X POST https://api.xtract.bot/api/zip-create \
  -H "Content-Type: application/json" \
  -H "Accept: application/octet-stream" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "level": 6,
  "names": "greetings.txt,readme.md",
  "files[0]": "__BASE64_FILES_0___",
  "files[1]": "__BASE64_FILES_1___"
}'