Copy media
Copies ready assets of the account to another seller.
Use it when the same photo goes to another seller. A listing's media must belong to the listing's seller, so the copy gives the seller in the path an asset of its own.
Send assetIds: each one must belong to your account and be ready, otherwise the answer is 409 asset_not_ready. The copy happens inside the storage, becomes a new asset with source: copy, and the original does not change.
api_keyAuthorizationBearer <token>API key (mk_...)
sellerId*stringSeller the new resource belongs to.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidIdempotency-Key?stringOptional. A unique value (for example a UUID), 1 to 255 characters, that makes the request safe to retry: repeating it with the same body within 24h returns the original response with Idempotency-Replayed: true instead of running the operation again. Scoped to your account. Reusing it with a different body returns 409.
1 <= length <= 255application/json- body
The assets to copy into the seller in the path.
assetIds*array<>Assets to copy, from any seller of the account. Each must be ready; no id may repeat.
1 <= items <= 100New ready assets of the seller in the path, in the order of assetIds. The originals are unchanged.
application/json- response
The copies, each a new asset of the target seller.
assets*array<>The new assets, in the order of assetIds. Class, type, size, hash and file name come from the original.
curl -X POST "https://example.com/v1/sellers/b6a1c0de-3f0c-4f53-9c6e-2a1d7d3b9e10/media-copies" \ -H "Content-Type: application/json" \ -d '{ "assetIds": [ "4a7f2701-c5f7-477f-9658-5ce6be74ef80" ] }'{ "assets": [ { "id": "1f0d7c2e-8b4a-4d6f-a3e9-5c7b2d1e0f48", "sellerId": "b6a1c0de-3f0c-4f53-9c6e-2a1d7d3b9e10", "class": "product_media", "status": "ready", "contentType": "image/jpeg", "sizeBytes": 482113, "sha256": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b", "filename": "front.jpg", "source": "copy", "failureReason": null, "url": "https://storage.example.com/marketapi-assets/assets/4a7f2701-c5f7-477f-9658-5ce6be74ef80?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=5d1b9c", "urlExpiresAt": "2026-10-16T12:15:00.000Z", "createdAt": "2026-10-16T12:00:00.000Z", "updatedAt": "2026-10-16T12:00:05.000Z" } ]}