Upsert multiple tags

Upsert an array of tags for articles

This endpoint will create or update tags based on the unique id field of each tag. If a tag with the same id already exists, it will be updated. Otherwise, a new tag will be created.

Request

A list of tags

idstringRequired>=1 character<=40 characters

A unique identifier for the tag

namestringRequired>=1 character<=40 characters

The name of the tag

Response

Tags upserted

successboolean

Whether the article tag was successfully created/updated

createdboolean

True if a new article tag was created, false if an existing article tag was updated

idstring

The id of the article tag

1	import requests
2
3	url = "https://example.ada.support/api/v2/knowledge/bulk/tags/"
4
5	payload = [
6	{
7	"id": "5df263b7db5a7e6ea03fae9b",
8	"name": "password_reset"
9	}
10	]
11	headers = {
12	"Authorization": "Bearer <apiKey>",
13	"Content-Type": "application/json"
14	}
15
16	response = requests.post(url, json=payload, headers=headers)
17
18	print(response.json())

Headers

Request

Response

Errors

1	[
2	{
3	"success": true,
4	"created": true,
5	"id": "5df263b7db5a7e6ea03fae9b"
6	}
7	]