Get Brand Images

Learn how to retrieve brand assets from your workspace

Overview#

This endpoint allows you to retrieve a list of brand assets (images) from your workspace. Brand assets can be used across your templates and designs.

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

Query Parameters#

Parameter	Type	Required	Description
`tag`	String	No	Comma-separated list of tags to filter by. Returns only assets that have all specified tags.

Request#

await fetch("https://api.orshot.com/v1/brand-assets/images/get", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Rate Limits#

30 requests per minute per endpoint

Response Fields#

Field	Type	Description
`id`	Number	Unique identifier for the asset
`created_at`	String	Timestamp when the asset was created
`direct_url`	String	URL to access the asset
`file_name`	String	Original filename of the asset
`file_size`	Number	Size of the file in bytes
`meta`	Object	Custom metadata associated with the asset
`tags`	String[]	Tags associated with the asset
`workspace_id`	Number	ID of the workspace the asset belongs to
`user_id`	String	ID of the user who created the asset

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