> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gavai.io/llms.txt
> Use this file to discover all available pages before exploring further.
# storeFile
> Upload a file to the workspace's object-store bucket and return a signed or public URL.
export const ExpectedOutput = ({caption = "Expected output", children}) => ;
export const ErrorTable = ({errors}) =>
Error
Cause
Fix
{errors.map((err, i) =>
{err.code}
{err.cause}
{err.fix}
)}
;
export const Def = ({term, type, defaultValue, required, children}) => <>
{term}
{type && {type}}
{required && required}
{defaultValue !== undefined &&
default {defaultValue}
}
{children}
;
export const DefList = ({children}) => {children}
;
export const ArrowItem = ({children}) =>
{"↳︎"}
{children}
;
export const ArrowList = ({children}) => ;
export const Eyebrow = ({label, tone = "default"}) =>
{label}
;
`storeFile` uploads a file to the workspace's object-store bucket and returns either a signed URL (private, expiring) or a public URL (permanent). Use it from a Form block with a file input to capture user uploads, or from a page-side handler to store generated content. By the end of this page you can wire a Form to accept an upload and render the returned URL — no manual bucket setup required, since every workspace gets its own object-store bucket auto-provisioned.
## Invoke from a Form block
Attach a file field to a Form block and bind `storeFile` to `on_submit`. The runtime passes the uploaded file's bytes as `body`.
```json upload-form.json theme={null}
{
"block": "Form",
"props": {
"schema_table": "uploads",
"fields": ["label", "file"],
"on_submit": {
"capability": "storeFile",
"args": {
"filename": "avatar.png",
"content_type": "image/png",
"body": "iVBORw0KGgoAAAANSUhEUgAA...",
"expires_in_seconds": 86400
}
}
}
}
```
In real usage the file field's name, MIME type, and base64-encoded bytes come from the submitted form rather than literal strings — the runtime substitutes them at dispatch time.
## Inputs
Destination filename in the bucket, e.g. `"avatar.png"`.
MIME type of the file, e.g. `"image/png"` or `"application/pdf"`.
File content as raw bytes (`ArrayBuffer`) or a base64-encoded string.
How long the signed URL remains valid. Defaults to one hour. Ignored when `public` is `true`.
If `true`, returns a permanent public URL instead of a signed URL.
## Outputs
Signed URL (when `public` is `false`) or permanent public URL (when `public` is `true`).
Stable key identifying the object in the bucket. Persist this if you need to mint a fresh signed URL after the original expires.
Size of the stored file in bytes.
ISO 8601 timestamp when the file was written to the bucket.
## Provisioning
No manual setup. Every workspace gets a dedicated object-store bucket on first use. Files are scoped to the workspace and are not accessible across workspace boundaries.
Signed URLs expire. The default TTL is one hour (`expires_in_seconds: 3600`). A URL used after `uploaded_at + expires_in_seconds` returns 403. To serve the same object again later, store `object_key` from the upload response and request a fresh URL when needed.
## Error codes
Every error returns the standard envelope:
```json error-envelope.json theme={null}
{
"ok": false,
"error": {
"code": "file_too_large",
"message": "Uploaded file exceeds the 25 MB workspace limit.",
"details": { "bytes": 31457280, "limit": 26214400 }
}
}
```
## Related
Read the signed-in user's profile to associate uploads with the user.
End-to-end walkthrough: Form block, file field, and rendering the result.