Upload Catalog Image

Staging Env

https://api.stg.bidancer.com

POST

/catalog-service/v1/catalog/{catalogId}/image-upload

Last modified:2026-01-13 17:42:29

Upload an image for the catalog. If the catalog is not found, it will create an update request.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params multipart/form-data

Responses

🟢200OK

application/json

Success response for creating or updating a

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.stg.bidancer.com/catalog-service/v1/catalog//image-upload' \
--header 'Authorization: Bearer <token>' \
--form 'file=""' \
--form 'position=""'

Response Example

200 - Example 1

{
    "status": "success",
    "message": "string",
    "data": {
        "businessId": "string",
        "catalogId": "string",
        "title": "string",
        "description": "string",
        "descriptionHtml": "string",
        "nature": "string",
        "category": "string",
        "categoryId": "string",
        "altCategory": "string",
        "altCategoryId": "string",
        "vendor": "string",
        "productType": "string",
        "tags": [
            "string"
        ],
        "specifications": [
            {
                "category": "string",
                "fields": [
                    {
                        "name": "string",
                        "value": "string",
                        "valueType": "text",
                        "unit": "string",
                        "hint": "string"
                    }
                ]
            }
        ],
        "publishedAt": "string",
        "publishedScope": "string",
        "options": [
            {
                "id": "string",
                "name": "string",
                "position": 0,
                "values": [
                    "string"
                ]
            }
        ],
        "images": [
            {
                "id": "string",
                "src": "http://example.com",
                "position": 0,
                "alt": "string",
                "width": 0,
                "height": 0
            }
        ],
        "image": {
            "id": "string",
            "src": "http://example.com",
            "position": 0,
            "alt": "string",
            "width": 0,
            "height": 0
        },
        "warranty": {
            "periodMonths": 0,
            "coverage": "string",
            "termsUrl": "http://example.com"
        },
        "returnPolicy": {
            "returnWindowDays": 0,
            "restockingFeePercent": 0,
            "conditions": [
                "string"
            ]
        },
        "documentResource": {
            "type": "string",
            "url": "http://example.com",
            "label": "string"
        },
        "status": "pending",
        "approverComment": "string",
        "approverId": "string",
        "approverAt": "string",
        "id": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "deletedAt": "string"
    }
}

Modified at 2026-01-13 17:42:29

Get pending catalog update request

Update Catalog