Complete Upload
POST/v1/:slug/assets/upload_complete
Step 4 of 4-Step Asset Upload Process
This endpoint completes the asset upload process by creating the Asset record in Playbook's database.
Prerequisites:
You must have completed Steps 1-3 successfully:
- ✅ Called upload_prepare (got signed_gcs_id)
- ✅ Posted to GCS signed URL (initialized session)
- ✅ Put file data to session URL (uploaded file)
- 🔄 Now calling this endpoint (create Asset record)
What this endpoint does:
- Verifies the signed_gcs_id from Step 1
- Confirms the file exists in Google Cloud Storage
- Creates the Asset record in Playbook's database
- Triggers background processing (thumbnails, transcoding, etc.)
- Returns the complete Asset object with URLs and metadata
Important:
- Use the exact signed_gcs_id value from Step 1 response
- Do not URL-encode or modify the signed_gcs_id
- This step is required - without it, the file exists in GCS but not in Playbook
Request
Responses
- 200
- 401
- 404
- 422
Asset upload completed successfully
unauthenticated
file not found in GCS
invalid signed_gcs_id