Update a brand

PUT

/resellers/{reseller}/brands/{hostname}/{brand_name}

Last modified:2026-02-04 00:21:55

Update an existing brand identified by reseller + hostname + brand-name.

Note: hostname, reseller, and brand-name are immutable (they form the natural key).

If changing currently-active to 1, all other brands for this hostname+reseller will be automatically deactivated.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

Brand updated successfully

Body

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers//brands//' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "string",
    "currently-active": 0,
    "color-primary": "string",
    "color-secondary": "string",
    "color-success": "string",
    "color-info": "string",
    "color-error": "string",
    "color-warning": "string",
    "font-family": "string",
    "font-size-pixels": 8,
    "margin-pixels": 0,
    "padding-pixels": 0,
    "powered-by": "string",
    "email-sender": "user@example.com"
}'

Response Example

200 - Example 1

{
    "id": "285ed3196c8c1ae900033e5295026c4d",
    "hostname": "portal.acmecorp.com",
    "reseller": "acme-reseller",
    "brand-name": "ACME Blue Theme",
    "description": "string",
    "currently-active": 0,
    "color-primary": "string",
    "color-secondary": "string",
    "color-success": "string",
    "color-info": "string",
    "color-error": "string",
    "color-warning": "string",
    "font-family": "string",
    "font-size-pixels": 0,
    "margin-pixels": 0,
    "padding-pixels": 0,
    "powered-by": "string",
    "email-sender": "user@example.com",
    "created": "2019-08-24T14:15:22.123Z",
    "modified": "2019-08-24T14:15:22.123Z",
    "assets": [
        {
            "asset-type": "logo",
            "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
            "brand-id": "285ed3196c8c1ae900033e5295026c4d",
            "filename": "acme-logo.png",
            "mime-type": "image/png",
            "file-size": 45678,
            "width": 200,
            "height": 80
        },
        {
            "asset-type": "background",
            "id": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
            "brand-id": "285ed3196c8c1ae900033e5295026c4d",
            "filename": "acme-background.jpg",
            "mime-type": "image/jpeg",
            "file-size": 123456,
            "width": 1200,
            "height": 300
        }
    ],
    "matched-hostname": "portal.acmecorp.com"
}

Modified at 2026-02-04 00:21:55

Copy a brand to a new brand-name or hostname

Delete a brand