Skip to main content

Upload Business Category Asset (v1)

Upload business category image asset.

Method & Path

POST /v1/admin/business-categories/assets

Description

Uploads an image asset for a business category (e.g., category icon).

Authentication

Required: Admin authentication with businesses.manage permission.

Headers

Authorization: Bearer <admin_token>
Content-Type: multipart/form-data

Request Body (Form Data)

FieldTypeRequiredDescription
filefileYesImage file to upload
categoryIdstringYesCategory ID
categorySlugstringYesCategory slug
localestringYesLocale code

Response 201 Created

{
"image": {
"url": "https://example.com/category-asset.png",
"categoryId": "507f1f77bcf86cd799439011",
"locale": "en"
}
}

Common Errors

  • 401 Unauthorized: Missing or invalid admin authentication token
  • 403 Forbidden: Insufficient permissions
  • 400 Bad Request: Missing file or invalid request
  • 422 Unprocessable Entity: Validation errors
  • 500 Internal Server Error: Server error