For the complete documentation index, see llms.txt. This page is also available as Markdown.

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}/retry
  • Auth: API key as a bearer token, Authorization: Bearer $FLORA_API_KEY. See Authentication.

  • TypeScript SDK: client.assets.retry().

  • Idempotency: optional Idempotency-Key header. 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

Name
Type
Required
Description

assetId

string

Yes

Asset identifier. Pattern: ^asset_\S+$. Example: asset_abc123.

Responses

200: Asset upload retry created.

Field
Type
Required
Description

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.

Status
Code
Meaning

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?