Retry a signed asset upload
Retry a signed asset upload with the FLORA API: POST /assets/{assetId}/retry.
Creates a fresh signed upload reservation for a failed or expired asset upload. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.
POST https://app.flora.ai/api/v1/assets/{assetId}/retryAuth: API key as a bearer token,
Authorization: Bearer $FLORA_API_KEY. See Authentication.TypeScript SDK:
client.assets.retry().Idempotency: optional
Idempotency-Keyheader. See Idempotency.Operation ID:
retryAssetUpload.
Example
curl -X POST 'https://app.flora.ai/api/v1/assets/asset_abc123/retry' \
-H "Authorization: Bearer $FLORA_API_KEY"import { FloraClient } from '@flora-ai/flora';
const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });
const asset = await client.assets.retry({
assetId: 'asset_abc123',
});
console.log(asset);Path parameters
assetId
string
Yes
Asset identifier. Pattern: ^asset_\S+$. Example: asset_abc123.
Responses
200: Asset upload retry created.
asset_id
string
Yes
Asset identifier. Pattern: ^asset_\S+$. Example: asset_abc123.
url
string (uri) or null
Yes
Asset URL
workspace_id
string or null
Yes
Workspace identifier. Pattern: ^ws_\S+$. Example: ws_abc123.
visibility
string
Yes
Always workspace.
status
string
Yes
One of: pending_upload, ready, failed.
failure_message
string or null
No
Failure message when the asset is in failed status
upload
object
No
upload.url
string (uri)
Yes
Upload URL
upload.method
string
Yes
Always POST.
upload.content_type
string
Yes
Always multipart/form-data.
upload.file_field
string
Yes
Always file.
upload.form_fields
map of string
Yes
Upload form fields
upload_url
string
No
Upload URL (serialized). Example: https://storage.googleapis.com/flora-user-assets.
expires_at
string (date-time)
No
Expiration time for the upload URL
Errors
Every error has the same body: error.code, error.message, and error.fields on validation errors. See Errors for how to recover from each code.
400
invalid_json, input_validation_error
The body isn't valid JSON, or an input failed validation (fields lists each one).
401
unauthorized, invalid_api_key
The API key is missing, invalid or revoked.
402
insufficient_credits
The workspace balance is too low for this request.
403
forbidden, paid_plan_required
The key can't do this, or the workspace plan doesn't include it.
404
not_found
The resource doesn't exist or isn't visible to this key.
409
idempotency_duplicate, revision_conflict
Duplicate Idempotency-Key or a stale base_revision.
429
rate_limited
Too many requests. Back off and retry.
500
unknown_error, internal_error
Something failed on FLORA's side. Retry with backoff.
503
temporarily_unavailable
Authorization is temporarily unavailable. Retry later.
Last updated
Was this helpful?