GET: Brand Asset 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/getRequest
await fetch("https://api.orshot.com/v1/brand-assets/images/get", {
method: "GET",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
});{
"data": [
{
"id": "01234567-89ab-cdef-0123-456789abcdef",
"created_at": "2025-09-10T15:30:45.123Z",
"direct_url": "https://storage.orshot.com/brand-assets/workspace_id/brand-asset-1694444444.png",
"file_name": "brand-asset-1694444444.png",
"file_size": 42568,
"meta": {
"description": "Company logo",
"category": "logos"
},
"workspace_id": "98765432-10fe-dcba-9876-543210fedcba",
"user_id": "abcdef01-2345-6789-abcd-ef0123456789"
},
// Additional assets...
]
}Rate Limits
- 30 requests per minute per endpoint
Response Fields
| Field | Type | Description |
|---|---|---|
id | String | 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 |
workspace_id | String | ID of the workspace the asset belongs to |
user_id | String | ID of the user who created the asset |