PUT
/api/admin/branding/{asset_kind}AdminUpload a custom branding asset
Multipart form upload with the image under the file field (max 1MB). Replaces any previously uploaded asset of the same kind.
operationId
uploadBrandingAssetAdmin: BrandingAuthentication & permissionsAdmin
Platform administrators only
- Accepted credentials
- Access token (Bearer)
Authorization: Bearer <JWT> - Access token (cookie)
cookie "access_token_schemavaults-mail"
- Access token (Bearer)
- Who may call
- Platform administrators only
Path parameters
| Name | Type | Description |
|---|---|---|
| asset_kind* | BrandingAssetKind | Kind of white-label branding asset. |
Request body
Required
multipart/form-data
BrandingAssetUploadForm
| Property | Type | Description |
|---|---|---|
| file* | string (binary) | The image file (png, jpeg, webp, svg, or ico). |
Responses
application/json
| Property | Type | Description |
|---|---|---|
| success* | true | |
| data* | BrandingAssetMetadata | |
| asset_kind* | BrandingAssetKind | Kind of white-label branding asset. |
| content_type* | BrandingAssetContentType | MIME types accepted for uploaded branding assets. |
| updated_at* | number | Upload time as a Unix timestamp in milliseconds. minimum: 0 |
| message* | string |
JSONExample
"success"true
"data"
"asset_kind""logo"
"content_type""image/png"
"updated_at"1.5
"message""string"
Example request
bashcurl
curl -X PUT 'https://mail.schemavaults.com/api/admin/branding/<asset_kind>' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: multipart/form-data'