Skip to main content
Tags are organization-defined labels for resources such as invoices. They are useful for review queues, internal workflows, and grouping resources in your integration. Resource tags are separate from entity tags:
Tag typeUsed forIRI format
Resource tagsSupported resources such as invoices/tags/{id}
Entity tagsEntities/entity-tags/{id}
When applying tags to a resource, send the complete tags collection you want the resource to have. The submitted collection replaces the previous collection.
Entity tag operations are listed under Entities because they label entities. This section covers resource tags.

​
How Tags Are Used

  1. Create a tag for the resource type you want to label.
  2. Store the tag IRI returned by Syntage, such as /tags/{id}.
  3. Update the resource with the complete tags collection it should have.
  4. Use tags in your own integration to build queues, review states, grouping, or reconciliation workflows.

​
Example Tag

{
  "@id": "/tags/91106968-1abd-4d64-85c1-4e73d96fb997",
  "@type": "Tag",
  "id": "91106968-1abd-4d64-85c1-4e73d96fb997",
  "name": "Needs review",
  "resourceType": "invoice",
  "createdAt": "2026-06-16T14:30:00.000Z",
  "updatedAt": "2026-06-16T14:30:00.000Z"
}

​
Replacing Tag Assignments

When an endpoint accepts a tags collection, the request replaces the resource’s existing tag assignments. To add one tag without removing the current tags, first retrieve the resource, keep its existing tag IRIs, append the new tag IRI, and send the full list back. 
{
  "tags": [
    "/tags/91106968-1abd-4d64-85c1-4e73d96fb997",
    "/tags/018f3f8f-4538-7bbb-b432-9e97e34a564a"
  ]
}