Skip to main content

SDK Support

Beta

This feature is in beta. Core behavior is stable, but some APIs or configuration may change before general availability.

Storage exposes a broad surface on both the Client SDK and the Admin SDK. The main difference is whether access rules are enforced or bypassed with a Service Key.

Scope

This table compares storage capabilities by SDK role. For package and runtime availability, see SDK Layer Matrix. For the latest cross-runtime admin certification, see SDK Verification Matrix.

CapabilityClient SDKAdmin SDKNotes
Upload and download filesYesYesClient requests respect storage access rules. Admin requests bypass them.
Signed download and upload URL creationYesYesAccess rules are checked when the signed URL is created.
Multipart upload and resume flowsYesYesThe multipart surface exists on both sides. Server-only languages use the Admin SDK storage client.
Read and write file metadataYesYesSame file surface, different auth context.
Access rule enforcementYesNoAdmin and App Function storage calls bypass storage access rules.
Privileged file access and maintenance jobsNoYesUse Service Key-backed storage operations for backend workflows.

Use Client SDK When

  • users are uploading or downloading files directly
  • you want storage access rules enforced per user
  • you need signed URLs from an app-facing surface that still respects rules

Use Admin SDK When

  • you need privileged file access from your backend
  • you are generating signed URLs regardless of end-user auth context
  • you are running cleanup, moderation, or background storage jobs