Gzip Compress

Overview

You send a file_ref up to 25 MiB. We emit one gzip member, zero the header timestamp, and never embed an original path in the gzip header. The Squillify artifact is named from the source filename (report.pdf becomes report.pdf.gz). compressionLevel is DEFAULT, FAST, or BEST — not a raw deflate integer. This is not tar, ZIP, or a multi-member archive.

A wall-clock gzip timestamp or an embedded gzip FNAME makes two compressions of the same bytes diverge. The original name is stored on the Squillify artifact instead.

When to use it

Scope

Non-goals

• Does not build tar or ZIP archives
• Does not emit concatenated gzip members
• Does not encrypt the payload
• Does not write the original filename into the gzip FNAME header

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"file.gzip_compress","input":{"file_ref":"squillify://files/f-hello"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("file.gzip_compress", {"file_ref":"squillify://files/f-empty"});

Errors

Other limits

Limitations

• Does not build tar or ZIP archives
• Does not emit concatenated gzip members
• Does not encrypt the payload
• Does not write the original filename into the gzip FNAME header
• Packaging a directory tree
• Multi-member gzip streams

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "file.gzip_compress",
  "input": {
    "file_ref": "squillify://files/f-empty"
  }
}

Examples

{
  "file_ref": "squillify://files/f-empty"
}

{
  "filename": "payload.gz",
  "expiresAt": "2026-08-27T00:10:00Z",
  "sizeBytes": 20,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "mediaType": "application/gzip",
  "compressionLevel": "DEFAULT",
  "inputBytes": 0,
  "fileRef": "squillify://files/f-generated"
}

{
  "compressionLevel": "FAST",
  "file_ref": "squillify://files/f-hello"
}

{
  "filename": "hello.txt.gz",
  "expiresAt": "2026-08-27T00:10:00Z",
  "sizeBytes": 25,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "mediaType": "application/gzip",
  "compressionLevel": "FAST",
  "inputBytes": 5,
  "fileRef": "squillify://files/f-generated"
}

Recommended use cases

• Wrap a payload for a later single-member gunzip
• Produce a byte-identical gzip across retries

Avoid for

• Packaging a directory tree
• Multi-member gzip streams

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags