Artifacts & storage

Serverless › Artifacts is the gallery of everything your image and video requests produced. Text and embedding calls produce no files and never appear here.

The unit is the request, not the file

A request that generated 4 images shows 4 tiles sharing one request id. Selection and deletion always operate on the whole request’s output — there is no per-tile delete.

Where results are stored

Each request resolves its destination by priority:

1. storage_credential_id on the API request — per-call override.
2. The deployment’s default bucket — set in the Serving Edit drawer.
3. Managed — Meshive-operated storage. The default.

• Your buckets connect under Settings → Integrations: AWS S3, Cloudflare R2, MinIO, GCS (S3-compatible).
• Verified credentials only — an unverified/broken credential fails explicitly (422 at submit, or storage_upload_failed), never a silent fallback elsewhere.
• Sync calls follow the same priority. With your bucket configured, sync results are always uploaded there (even b64_json responses, for retention).

Retention

What	Where	Kept for
Async results (the gallery)	Managed	The retention window — shown in the gallery banner, 10 days by default — then auto-deleted. Each tile shows its delete at time
Async results	Your bucket	Forever — Meshive never deletes from your buckets
Sync image results (response_format=url)	Managed	Link lasts ~1 hour, object removed shortly after — download immediately, use b64_json, or set an output bucket
Sync image results	Your bucket	Forever (links signed ~7 days; re-fetch to re-sign)

• The retention window is platform configuration — the gallery banner and each tile’s delete at always show the live value.
• Need something past the window? Download it, or point the deployment (or request) at your own bucket.

Browsing the gallery

• Filters — modality group × bucket (Managed / each credential); sort newest or oldest.
• Tiles — thumbnail, modality, resolution, model, created time, bucket label, and (Managed) scheduled deletion.
• Lightbox — arrow navigation, view original, download.
• Links don’t go stale — URLs are re-signed on every visit (views ~6h, downloads with attachment headers). A tab left open overnight may 403 — refresh.
• Long galleries — cursor pagination; pass next_cursor through if using the API.

Deleting

• Multi-select, up to 200 requests per batch; deletion removes the request’s entire output.
• Partial failures are reported, not hidden — “N deleted, M failed”. Most common cause: a revoked credential on your own bucket. Re-verify under Settings → Integrations and retry.
• Managed results also age out on their own at delete at; your buckets never auto-expire.

Result links elsewhere

Surface	Link lifetime
GET /v1/requests/{id} → output_urls	~1 hour (Requests)
GET /v1/videos/{id}/content	302-redirect to a ~1-hour link (Videos API)
Artifacts gallery	~6 hours, re-signed every visit

Links expiring is normal. Permanent access = downloading the file, or owning the bucket it lives in.