Upload Brand Image

Learn how to upload brand assets to your workspace

Overview#

This endpoint allows you to upload new brand assets (images) to your workspace. You can upload images from a URL or as a base64-encoded string.

https://api.orshot.com/v1/brand-assets/images/add

Request#

await fetch("https://api.orshot.com/v1/brand-assets/images/add", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    file: "https://example.com/path/to/image.png", // supports base64, url or binary
    fileName: "company-logo.png", // optional
    fileType: "image/png", // optional
    tags: ["logo", "brand"], // optional
  }),
});

Request Parameters#

Parameter	Type	Required	Description
`file`	String	Yes	URL, binary or base64-encoded string of the image
`fileName`	String	No	Custom filename for the asset (default: auto-generated based on timestamp)
`fileType`	String	No	MIME type of the file (e.g., "image/png"). If not provided, it will be detected from the file
`tags`	String[]	No	Array of tags to associate with the asset (e.g., `["logo", "brand"]`)

Supported Image Formats#

PNG (image/png)
JPEG (image/jpeg)
WebP (image/webp)
SVG (image/svg+xml)
GIF (image/gif)

Notes#

Images are automatically optimized and resized if needed (maximum dimensions: 2000x2000 pixels)
Maximum file size: 8MB
SVG files are not optimized to preserve their vector format

Rate Limits#

30 requests per minute per endpoint

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key

Image, PDF and video generation via API
Visual editor with AI and smart layouts
Zapier, Make, MCP and 50+ integrations
White-label embed for your own app
60 free renders — no credit card required