Update Color Tags

Learn how to update tags on a saved brand color

Overview#

This endpoint allows you to update the tags on a specific saved color in your workspace.

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

Request#

await fetch("https://api.orshot.com/v1/brand-assets/colors/update/123", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    tags: ["primary", "brand", "buttons"],
  }),
});

Path Parameters#

ParameterTypeRequiredDescription
idNumberYesThe unique identifier of the color to update

Request Parameters#

ParameterTypeRequiredDescription
tagsString[]YesArray of tags to set on the color (replaces any existing tags)

Notes#

  • Tags are automatically normalized: trimmed, deduplicated (case-insensitive), and empty values are removed
  • Passing an empty array [] will clear all tags from the color

Error Responses#

Color Not Found (404)#

{
  "error": "Color not found"
}

Invalid Tags (400)#

{
  "error": "\"tags\" must be an array of strings"
}

Rate Limits#

  • 30 requests per minute per endpoint
←
Previous
Add Color
Next
Delete 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