Skip to main content

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:

  1. ✅ Called upload_prepare (got signed_gcs_id)
  2. ✅ Posted to GCS signed URL (initialized session)
  3. ✅ Put file data to session URL (uploaded file)
  4. 🔄 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

Asset upload completed successfully