# Brand assets

Source: https://parasend.com/docs/api/brand-assets

Eight plan-gated theme knobs, WCAG contrast validated at save. Trust chrome and "Powered by Parasend · by Justikal" are outside customer control on every tier.

## Endpoints

- [Upload a brand asset](https://parasend.com/docs/api/brand-assets/upload.md): `POST /v1/brand_assets`
- [Retrieve a brand asset](https://parasend.com/docs/api/brand-assets/retrieve.md): `GET /v1/brand_assets/{id}`
- [Download a brand asset](https://parasend.com/docs/api/brand-assets/download.md): `GET /v1/brand_assets/{id}/content`

## The BrandAsset object

- `id` (string, required): The brand asset's ID, starting `bas_`.
- `object` (string, required): Always `brand_asset`.
- `kind` (string, required): `logo`, `image` (a page photo) or `icon` (the browser tab's icon). One of: `logo`, `image`, `icon`.
- `content_type` (string, required): What is served — a logo's or an icon's PNG, a photo's WebP. One of: `image/png`, `image/webp`.
- `source_type` (string, required): What was uploaded (a logo's is kept, never served; a photo's is not kept). One of: `image/png`, `image/svg+xml`, `image/jpeg`, `image/webp`.
- `sha256` (string, required): Of the PNG (a photo's large WebP).
- `width` (integer, required): A logo: CSS pixels (the PNG is 3× this). A photo: pixels of the large rendition. An icon: 180.
- `height` (integer, required): A logo: CSS pixels. A photo: pixels of the large rendition. An icon: 180.
- `url` (string, required): The path of the image itself, `/v1/brand_assets/{id}/content`: a logo's or an icon's PNG, or a photo's large WebP. Fetch it with your API key, like any other request.
- `created_at` (string · date-time, required): When the asset was uploaded, in ISO 8601 (UTC).
- `small` (object, optional): A photo: the small rendition, about 800 pixels wide. An icon: the 32 pixel PNG.
  - `small.url` (string, optional)
  - `small.width` (integer, optional)
  - `small.height` (integer, optional)
- `transparent_background` (boolean · nullable, optional): A logo only: whether most of its outer edge is transparent. null for a photo or an icon.

```json
{
  "id": "bas_01M6R27T7R9RDBHE6X72ZRW3YC",
  "object": "brand_asset",
  "kind": "logo",
  "content_type": "image/png",
  "source_type": "image/png",
  "sha256": "f72bdd36e6ce104c53c8f21bd9e618e113a66f4d6729d43a4cb07b3f1373addb",
  "width": 200,
  "height": 48,
  "url": "/v1/brand_assets/bas_01M6R27T7R9RDBHE6X72ZRW3YC/content",
  "transparent_background": false,
  "created_at": "2026-11-06T09:15:05.848Z"
}
```