v20
latestOpenAPI 3.1.02026-08-08122113375.9 KBseller-listings
Create attachment
Create a draft attachment upload for a listing and return a direct upload URL.
This is step 1 of the listing attachment workflow.
Workflow:
- Call this endpoint to obtain id and uploadURL.
- Upload the image bytes directly to the returned URL.
- Call finalize attachment to validate and persist the attachment on the listing.
Rules:
- Listing must belong to the authenticated seller.
- Listing must be active (quantity > 0).
- The returned image identifier is namespaced to the listing and seller context.
Response:
- Returns an ImageUpload payload with the image identifier and direct upload URL.
post/seller/listings/{id}/attachments
Path parameters
idstring required
Listing ID
Listing ID
Response
Upload URL