POST/vendor/me/logoVendor bearer token required

Upload Vendor Logo

Upload a logo image for your vendor profile (multipart/form-data).

What this means in plain English

Upload a logo image file for your vendor store. Requires OWNER, ADMIN, or EDITOR role.

When to use this

Set or replace the vendor store logo.
Updating store branding after a rebrand.

Request body

Name	Type	Required	Description
file	file	Yes	Image file (jpeg, png, gif, or webp).

Request example

curl -X POST 'https://api.next.gcommerce.glass/api/v1/vendor/me/logo' \
  -d '{
  "file": "logo.png"
}'

Response examples

200Success

{
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "status": "ACTIVE",
  "name": "Jane's Store",
  "slug": "janes-store",
  "code": "JNS01",
  "dba": null,
  "restrictProducts": false,
  "leadTime": 4,
  "description": "Premium supplier catalog",
  "image": "https://api.next.gcommerce.glass/assets/vendors/logos/janes-store.png",
  "supportEmail": "support@janes-store.com",
  "publicLocationCity": "Austin",
  "publicLocationRegion": "TX",
  "publicLocationCountry": "US",
  "address": "123 Commerce Blvd",
  "additionalAddress": "Suite 400",
  "zipcode": "78701",
  "phone": "+1-512-555-0100",
  "contactPersonFullName": "Jane Vendor",
  "contactPersonRole": "Owner",
  "website": "https://janes-store.com",
  "yearEstablished": 2015,
  "businessNumber": "BN-123456",
  "sbuei": "ABC123DEF456",
  "taxNumber": "12-3456789",
  "last_login_at": "2026-06-15T14:30:00.000Z",
  "createdAt": "2025-01-10T09:00:00.000Z",
  "updatedAt": "2026-06-15T14:30:00.000Z",
  "shippingMethods": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440060",
      "name": "Standard Shipping",
      "isActive": true,
      "pricingType": "FLAT_RATE",
      "weightLimitMin": null,
      "weightLimitMax": null,
      "currency": "USD",
      "description": "5-7 business days",
      "createdAt": "2025-03-01T10:00:00.000Z",
      "updatedAt": "2025-03-01T10:00:00.000Z"
    }
  ],
  "documents": []
}

Status codes

200

Request succeeded.

401

Unauthorized

Missing or invalid bearer token.

403

Forbidden

Insufficient permissions for this action.

400

Bad Request

Validation failed or invalid parameters.

404

Not Found

Resource not found.

429

Too Many Requests

Global rate limit exceeded (10,000 requests per 10 minutes per IP).

500

Internal Server Error

Unexpected server error.

403

Forbidden

No vendor membership, or insufficient vendor role (requires OWNER, ADMIN, or EDITOR for write operations).

Send as multipart/form-data with field name `file`.

Example: `curl -X POST '{API_ORIGIN}/api/v1/vendor/me/logo' -H "Authorization: Bearer TOKEN" -F "file=@logo.png"`

Response `image` is the absolute public logo URL under `{API_ORIGIN}/assets/vendors/…` (see [Media URLs](/docs/v1/vendor#media-urls-images--documents)).

Try it

Edit values below to generate a cURL command. This endpoint requires multipart upload — run in your terminal.

Bearer tokenfile *

Copy-only

Multipart and file-download endpoints cannot be executed from the browser panel. Copy the cURL command and run it in your terminal.