- Integrations
- /
- Google Cloud Storage
- /
- Actions
- /
- List GCS Objects
ActionGoogle Cloud StorageUpdated May 2026
How do I list objects in a GCS bucket?
Short answer: Drop the "Google Cloud Storage → List GCS Objects" action anywhere in your workflow, map the inputs from upstream nodes, and publish.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Bucket bucket | string | Optional | — |
Prefix Filter prefix | string | Optional | — |
Max Results maxResults | string | Optional | — |
Sample request
{"bucket": "{{trigger.bucket}}","prefix": "{{trigger.prefix}}","maxResults": "{{trigger.maxResults}}"}
Returns
{"items": [{"name": "file.png","size": "12345","mediaLink": "https://storage.googleapis.com/..."}]}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for List GCS Objects.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about List GCS Objects.
What does the List GCS Objects action do in Google Cloud Storage?
Returns paginated objects in a bucket with optional prefix filter. Useful for batch processing or for inventorying bucket contents.
What inputs does List GCS Objects require?
List GCS Objects has no required inputs. Sensible defaults are applied if you leave fields blank.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Google Cloud Storage returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does List GCS Objects support batch operations?
Yes. Run List GCS Objects inside a Loop node to process arrays. Tiny Command handles Google Cloud Storage's rate limits automatically so you don't have to throttle manually.
More actions
Other Google Cloud Storage actions.
Action
Delete GCS Object
Removes a specific object from a bucket. Irreversible. For cleanup workflows after processing or for "GDPR right-to-erasure → delete user-uploaded files" compliance patterns.
ActionGet GCS Object Metadata
Returns size, content-type, generation, MD5, custom metadata for an object — without downloading the content bytes. Useful for inventory or "did this file exist?" pre-flight checks.
ActionGet Signed URL (Public Download)
Generates a time-limited URL that anyone can use to download the object without GCS auth. For "email the customer their export file" workflows that don't want to proxy bytes through the workflow runtime.
ActionUpload GCS Object
Uploads an object from URL, base64, or text content with optional metadata and content-type. For files >32MB, the simple upload path caps out — use resumable uploads via HTTP action.
Send list gcs objects from your workflows.
Triggered by anything in the catalog. Free tier available. No credit card.