Create or update tags

Upserts a batch of tags in the caller's tenant in a single transaction:

  • a record without id creates a new tag and publishes a tag-created domain event (ETagCreatedEvent);
  • a record with id updates the label and active flag of that existing tag (no event is published for updates).

Tags not mentioned in the request are left untouched — this is not a full replace, and tags cannot be deleted through this operation (use DELETE /tags/{tagId}). The response contains only the created/updated tags, in request order.

Authorization: requires the global:metadata:manage scope.

Errors (400): empty tags list; the same label used twice in one request; a blank label or a label longer than 255 characters; missing active; an id that does not exist in the tenant; a concurrent modification of the same tag. Duplicate labels are only checked within the request, not against tags that already exist. Any error rolls back the whole batch.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Tags to create (no id) and/or update (existing id). At least one record; labels must be unique within the request.

Batch of tags to create and/or update in the caller's tenant

tags
array of objects
required
length ≥ 1

Tags to create or update; at least one.

tags*
Responses

400

Invalid request (see description) — nothing is saved.

403

The token lacks the global:metadata:manage scope.

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*