Skip to content

upload_asset_complete

Management

Complete Upload

Finalize an upload started by upload_asset. For a multipart upload, call this only after every file part has been uploaded to the presigned URLs; for an inline upload that returned an upload_id (timeout, in_progress, or a finalization error), call it to resume. Completes the upload on the server and polls until the asset is ready, streaming progress notifications (finalizing → validating → creating asset → ready) while it waits. Args: - upload_id: required — returned by upload_asset - team_id, project_id: required for OAuth callers Returns: the completed asset_id and status when the upload finishes, or a timeout status if the asset is still being processed. Examples: - "Finish the multipart upload" -> upload_id="<upload_id from upload_asset>" - "Complete upload after PUTing all parts" -> call upload_asset_complete once every part upload succeeded Don't use when: upload_asset already returned an asset_id from the inline base64 path.
idempotentopen-world

Parameters

NameTypeRequiredDescription
upload_idstring✓Upload ID returned by upload_asset
team_idstring—Team ID. Required with project_id for OAuth callers; an API key is scoped by the key.
project_idstring—Project ID. Required with team_id for OAuth callers; an API key is scoped by the key.
response_formatenum(json | markdown)jsonOutput format: 'json' for structured data, 'markdown' for human-readable text.