Skip to content

Tags

Articles carry tags — short labels (e.g. "LED", "Eigenmarke") your team manages in the Mercura admin UI under Settings → Article tags. Send them by name: POST /articles accepts a tags array of names, and the read endpoints return the same names — you never deal with Mercura's internal numeric tag ids.

{ "article_number": "LEU-1500-50-840", "name": "LED-Feuchtraumleuchte 1500 mm 50 W 4000 K IP65", "tags": ["LED", "Eigenmarke"] }
  • Every name you send must already exist for your organisation. An unknown name fails the whole batch (the job ends FAILED with a message listing the offending names) — create the tag in the admin UI first, then retry.
  • Sending tags replaces the article's current tags. Omit the field to leave the tags unchanged; send [] to clear them.