> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a ZIP from cloud files

> Takes a list of Google Cloud Storage file URLs and creates a compressed ZIP archive containing those files. The ZIP is streamed directly back to the requester without being stored on disk. Requires `zip.archive.creator` permission.



## OpenAPI

````yaml api-reference/zip.yaml post /archives/create
openapi: 3.0.3
info:
  title: zip
  description: >-
    The Zip Service handles requests to bundle multiple files from cloud storage
    into a single compressed archive. It efficiently retrieves the requested
    objects, packages them into a ZIP file, and streams the result directly back
    to the requester.
  version: 1.0.0
servers:
  - url: https://zip.platform.arb.inc
security: []
tags:
  - name: /
  - name: archives
paths:
  /archives/create:
    post:
      tags:
        - archives
      summary: Create a ZIP from cloud files
      description: >-
        Takes a list of Google Cloud Storage file URLs and creates a compressed
        ZIP archive containing those files. The ZIP is streamed directly back to
        the requester without being stored on disk. Requires
        `zip.archive.creator` permission.
      operationId: createArchive
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - files
              properties:
                files:
                  type: array
                  description: List of files to include in the ZIP.
                  items:
                    type: object
                    required:
                      - gsURL
                      - name
                    properties:
                      gsURL:
                        type: string
                        format: uri
                        description: >-
                          Google Cloud Storage object URL beginning with
                          `gs://`.
                        example: gs://my-bucket/reports/2025/summary.pdf
                      name:
                        type: string
                        description: Name of the file inside the ZIP.
                        example: summary.pdf
                      path:
                        type: string
                        description: Optional path inside the ZIP.
                        example: reports/2025/
            examples:
              simpleZip:
                summary: Minimal example with two files
                value:
                  files:
                    - gsURL: gs://my-bucket/invoices/jan.csv
                      name: january.csv
                      path: data/invoices/
                    - gsURL: gs://my-bucket/invoices/feb.csv
                      name: february.csv
                      path: data/invoices/
      responses:
        '200':
          description: ZIP stream is returned for download.
          headers:
            Content-Type:
              description: MIME type of the response.
              schema:
                type: string
                example: application/zip
              example: application/zip
            Content-Disposition:
              description: Suggests a filename for the downloaded ZIP.
              schema:
                type: string
                example: attachment; filename="archive.zip"
              example: attachment; filename="archive.zip"
            Cache-Control:
              description: Caching directive.
              schema:
                type: string
                example: no-store
              example: no-store
            Pragma:
              description: Legacy caching directive.
              schema:
                type: string
                example: no-cache
              example: no-cache
          content:
            application/zip:
              schema:
                type: string
                format: binary
              examples:
                zipStream:
                  summary: Binary ZIP stream
                  description: The response body is a streamed ZIP file.
                  value: (binary zip stream)
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````