Complete media upload
POST/media/:id/complete
Signal that a file upload is finished. Call this after uploading your file to the presigned URL returned by POST /media/upload.
Processing by type:
- Images — Marked as ready immediately (Cloudflare Images handles optimization)
- Videos — File verified in storage, thumbnail generated in background, marked as ready
- Documents (PDF) — File verified in storage, marked as ready
The response includes the final status and a message with next steps.
Request
Responses
- 200
- 400
- 401
- 404
- 429
- 500
Media upload completed
Upload not ready or file verification failed
Missing or invalid API key
Resource not found
Rate limit exceeded
Response Headers
X-RateLimit-Limit
Request limit per window
X-RateLimit-Remaining
Remaining requests in current window
X-RateLimit-Reset
Unix timestamp when the window resets
Retry-After
Seconds to wait before retrying
Internal server error