Update Brand - Salla Merchants APIs

This endpoint allows you to update brand details by passing the brand as a path parameter.

Information

All variables in the Update Brand body request are optional.

Updating one variable at a time is possible, but at least one of the variables must be in the body request payload. Otherwise, an error will be shown if you send an empty body request payload.

Scopes

brands.read_write- Brands Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

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

Path Params

brand

integer

required

Unique identifier assigned to the Brand. List of Brand IDs can be found here

Body Params application/json

name

string

required

logo

string

required

banner

string

required

description

string

required

metadata_title

string

required

metadata_description

string

required

metadata_url

string

required

translations

object

required

object

required

Example

{
    "name": "ابل",
    "logo": "",
    "banner": "",
    "description": "شركه ابل",
    "metadata_title": "ابل",
    "metadata_description": "شركه ابل",
    "metadata_url": "apple",
    "translations": {
        "en": {
            "name": "Apple",
            "description": "Apple brand",
            "metadata_title": "Apple",
            "metadata_description": "Apple brand",
            "metadata_url": "apple",
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Brand details updated successfully.

application/json

Body

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (Brand)

optional

Detailed structure of the brand model object showing its fields and data types.

number

required

A unique identifier assigned to a specific brand.

name

string

required

The label given to a particular company, to identify its products in the market. 🌐 Support multi-language

description

string

required

A brief summary of a company, highlighting key attributes, values, and offerings to convey its identity and purpose. 🌐 Support multi-language

banner

string

required

A text or URL linking to a banner file, used as a visual identifier for a brand on a webpage or platform.

logo

string

required

A text-based representation or URL link that directs to the logo file.

ar_char

string

required

Brand represented in Arabic characters.

en_char

string

required

Brand represented in English characters.

metadata

object

required

Example

{
    "success": true,
    "status": 200,
    "data": {
        "id": 883017162,
        "name": "بربري",
        "description": "بربري",
        "banner": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
        "logo": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
        "ar_char": "ب",
        "en_char": "b",
        "metadata": {
            "title": "Zara brand",
            "description": "Brand awareness seo",
            "url": "zara/item"
        }
    }
}

🟠404Record Not Found

🟠422Error Validation

🟠401Unauthorized