Tag content API

Work with content in the context of a tag, for example by assigning content to it. The tag must already exist. You can create a tag first. Before you start, read the API overview for how authentication, headers, pagination and errors work.

Assign content to a tag

Assign a list of content items to an existing tag. You can identify the content by URL, by slug, or both.

string

The name of the tag’s parent tag.

string

required

The name of the tag to assign the content to.

string[]

The URLs of the content to assign to the tag.

string[]

The slugs of the content to assign to the tag.

Assign content to a tag

curl -X PUT "https://your-community.zapnito.com/api/v1/tags/contents?parent_name=Regulation" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "tag": {
      "name": "Compliance",
      "content_urls": [
        "https://your-community.zapnito.com/posts/preparing-for-an-audit",
        "https://your-community.zapnito.com/documents/annual-compliance-checklist"
      ],
      "content_slugs": [
        "preparing-for-an-audit"
      ]
    }
  }'

PUT https://your-community.zapnito.com/api/v1/tags/contents

{
  "tag": {
    "name": "Compliance",
    "external_url": "https://example.com/regulation/compliance",
    "external_id": "1221",
    "parent_name": "Regulation",
    "content_urls": [
      "https://your-community.zapnito.com/posts/preparing-for-an-audit",
      "https://your-community.zapnito.com/documents/annual-compliance-checklist"
    ]
  }
}

{
  "errors": {
    "content_urls": ["No matching items of content found"]
  }
}

200 OK: the content was assigned to the tag.
404 Not Found: no content matches the URLs or slugs you provided.

Getting started

Users

Groups and organisations

Content

Channels and rooms

Badges

Assign content to a tag

​Assign content to a tag

Assign content to a tag