Get Colors

Learn how to retrieve saved brand colors from your workspace

Overview#

This endpoint allows you to retrieve a list of saved brand colors from your workspace. Brand colors can be used across your templates and designs for consistent branding.

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

Query Parameters#

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

Request#

await fetch("https://api.orshot.com/v1/brand-assets/colors/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 color
`created_at`	String	Timestamp when the color was saved
`type`	String	Color type: `hex`, `rgb`, `hsl`, or `gradient`
`value`	String	The color value (e.g., `#FF5733`, `rgb(255, 87, 51)`)
`tags`	String[]	Tags associated with the color
`workspace_id`	Number	ID of the workspace the color belongs to
`user_id`	String	ID of the user who saved the color

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