Complete signed uploads in bulk
Complete signed uploads in bulk with the FLORA API: POST /assets/complete.
Completes up to 25 signed uploads in one request — the batch counterpart of POST /assets/{assetId}/complete, counted once against the workspace's rate limit instead of once per file. Every asset is verified and validated as the single completion does. Each entry echoes its index and asset_id and reports status ready, or failed with failure_message, exactly as the single completion would; ok is false with an error only when completion could not run for that asset — an id that is missing, deleted or outside this credential's write access reports not_found, the single completion's deliberate ambiguity. A failed entry never stops the rest, and a repeated id completes once and reports under each index. Assets reserved with project_id land on that project's canvas without stacking on one another. A malformed asset_id rejects the whole request. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate, and a batch whose every entry was rejected releases its key (see the Idempotency guide).
POST https://app.flora.ai/api/v1/assets/completeAuth: API key as a bearer token,
Authorization: Bearer $FLORA_API_KEY. See Authentication.TypeScript SDK:
client.assets.completeUploads().Idempotency: optional
Idempotency-Keyheader. See Idempotency.Operation ID:
completeAssetUploads.
Example
curl -X POST 'https://app.flora.ai/api/v1/assets/complete' \
-H "Authorization: Bearer $FLORA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"asset_ids": [
"asset_abc123"
]
}'import { FloraClient } from '@flora-ai/flora';
const client = new FloraClient({ apiKey: process.env['FLORA_API_KEY'] });
const asset = await client.assets.completeUploads({
asset_ids: [
'asset_abc123',
],
});
console.log(asset);Request body
Required.
asset_ids
array of string
Yes
Signed-upload asset ids (asset_…) to complete, 1 to 25 per call. 1 to 25 items.
Responses
200: Uploads completed; each entry reports its own outcome.
assets
array of objects
Yes
One entry per requested asset id, in request order: ok true with the single completion's fields, or ok false with error. At most 25 items. See the assets[] shapes below.
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?