v1

latestOpenAPI 3.1.02026-07-13154170539.0 KB
Storage

Generate a signed URL for a GCS object

Generates a temporary signed URL that provides time-limited access to a Google Cloud Storage object without requiring authentication.

The signed URL can be used to download the object directly via HTTP GET.

post/v0/storage/signed-url

Request body

gcs_uristring required

GCS URI of the object (e.g., gs://bucket-name/path/to/object)

expiration_minutesinteger

URL expiration time in minutes (1-10080, default 60)

downloadboolean

If true, the signed URL will force download with Content-Disposition: attachment

filenamestring nullable

Override the filename in Content-Disposition header (only used when download=True)

Example request

{
  "gcs_uri": "gs://my-bucket/images/photo.jpg"
}

Response

Signed URL generated successfully

signed_urlstring required

Temporary signed URL for accessing the object

expires_in_minutesinteger required

URL expiration time in minutes