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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a list of objects.

idstringRequired1-40 characters

A unique identifier for the tag

namestringRequired1-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

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

500

Internal Server Error

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 <token>",
13	"Content-Type": "application/json"
14	}
15
16	response = requests.post(url, json=payload, headers=headers)
17
18	print(response.json())