Upload Cart Input Field

POST

{store_url}/api/v1//cart/uploads

Uploads a file input used by cart items (e.g., image uploads, documents, or custom input attachments).

This endpoint is typically used before or during add-to-cart, where the returned file reference is later attached to a cart item’s custom/input field.

Note

Uploaded files are temporary and must be used before temporary_url_expiry_date.

The returned path or temporary_url is typically referenced when adding a cart item with input/custom fields.

Uploading a file does not add it to the cart by itself.

This endpoint is often used together with POST /cart/items.

Request

Body Params multipart/form-dataRequired

Responses

🟢201Success

application/json

Bodyapplication/json

🟠422Validation Error

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '{store_url}/api/v1//cart/uploads' \
--form 'upload=@"custom_image.jpg"'

Response Example

201 - Example 1

{
    "path": "cart/uploads/tmp/abc123.jpg",
    "temporary_url": "https://cdn.example.com/tmp/abc123.jpg",
    "temporary_url_expiry_date": "2025-12-29T07:14:29.659Z",
    "property1": "string",
    "property2": "string"
}

Modified at 2026-02-19 10:43:15

Remove Cart Item

Add Gift Card

Upload Cart Input Field

Note#

Request

Responses

Note