---
title: "Download a GCS object as base64"
method: POST
path: "/v0/storage/download"
tags: ["Storage"]
---

# Download a GCS object as base64

`POST /v0/storage/download`

Downloads the content of a Google Cloud Storage object and returns it
as a base64-encoded string.

This is useful for retrieving binary content (images, files) through
the API without requiring direct GCS access.

## Request body

- DownloadRequest — Request body for downloading object content.
  - `gcs_uri` string, required — GCS URI of the object (e.g., gs://bucket-name/path/to/object)

## Response `200`

Object content downloaded successfully

- DownloadResponse — Response body containing the object content.
  - `content_base64` string, required — Base64-encoded content of the object
  - `content_type` string, nullable — MIME type of the object if available
  - `size_bytes` integer, required — Size of the object in bytes

## Other responses

- `400` — Invalid GCS URI format
- `404` — Object not found in GCS
- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)