Upload a new image or video asset to a Lightroom catalog using the two-step create-asset-then-upload-binary workflow, including chunked upload for files over 200MB

Steps

1. Generate a new globally unique identifier without hyphens (per RFC-4122) to use as the asset_id
2. Create the asset record with PUT /v2/catalogs/{catalog_id}/assets/{asset_id}, sending a JSON body with subtype and payload.importSource fields (fileName, importedOnDevice set to the partner API key, importedBy, importTimestamp); expect a 201 Created response
3. Upload the binary file data with PUT /v2/catalogs/{catalog_id}/assets/{asset_id}/master, setting Content-Type to the file's media type
4. For files larger than 200MB, split the upload into parts and issue multiple PUT requests to the same master endpoint with Content-Range headers for each chunk; parallel chunk uploads are allowed
5. Handle a 412 Precondition Failed response as a duplicate-asset signal (the file's SHA-256 already matches an existing asset) and skip re-uploading it
6. Handle 413 (storage full) and 415 (content type mismatch) error responses by checking entitlement.storage before retrying and verifying the Content-Type header matches the actual file type