Gzip Decompress

Overview

You send a gzip file_ref up to 25 MiB. We inflate exactly one member, bound the output with maxOutputBytes (default 50 MiB, maximum 100 MiB), and reject a second member. The uncompressed artifact restores the Squillify filename and MIME type (report.pdf.gz becomes report.pdf). Optional outputFilename and outputMediaType override that for external gzip. trailingData=REJECT is the default; ALLOW_EMPTY permits zero padding only. This is not tar extraction or content decoding.

An unbounded inflater turns a small gzip member into a zip bomb on the API JVM.

When to use it

Scope

Non-goals

• Does not walk tar archives
• Does not decode concatenated gzip members
• Does not trust gzip FNAME headers

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_decompress","input":{"file_ref":"squillify://files/f-hello-gz"}}'

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

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

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

Errors

Other limits

Limitations

• Does not walk tar archives
• Does not decode concatenated gzip members
• Does not trust gzip FNAME headers
• Extracting tar.gz directory trees
• Decoding concatenated members as one stream

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "file.gzip_decompress",
  "input": {
    "file_ref": "squillify://files/f-hello-gz"
  }
}

Examples

{
  "file_ref": "squillify://files/f-hello-gz"
}

{
  "mediaType": "text/plain",
  "trailingData": "REJECT",
  "fileRef": "squillify://files/f-generated",
  "sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
  "expiresAt": "2026-08-27T00:10:00Z",
  "inputBytes": 25,
  "maxOutputBytes": 52428800,
  "filename": "hello.txt",
  "sizeBytes": 5
}

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

{
  "mediaType": "application/octet-stream",
  "trailingData": "REJECT",
  "fileRef": "squillify://files/f-generated",
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "expiresAt": "2026-08-27T00:10:00Z",
  "inputBytes": 20,
  "maxOutputBytes": 52428800,
  "filename": "payload",
  "sizeBytes": 0
}

Recommended use cases

• Round-trip a file.gzip_compress member
• Reject a zip-bomb-style expansion before allocation

Avoid for

• Extracting tar.gz directory trees
• Decoding concatenated members as one stream

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