Manage tag assignments

Assign or remove tags from recipes or connections for a specific managed user. Use the List Tags endpoint to retrieve tag handles.

Path parameters

idstringRequired

Embedded customer ID (external ID). The External ID must be URL encoded and prefixed with an E. For example, EA2300.

Headers

AuthorizationstringRequired

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

Request

This endpoint expects an object.
add_tagslist of stringsOptional
An array of tag handles to be added. Each handle represents a tag to be applied to the specified assets.
remove_tagslist of stringsOptional
An array of tag handles to be removed. Each handle represents a tag to be removed from the specified assets.
recipe_idslist of integersOptional

An array of recipe IDs to tag or untag. Required if connection_ids is not provided.

connection_idslist of integersOptional

An array of connection IDs to tag or untag. Required if recipe_ids is not provided.

Response

Success reply
successboolean or null
Indicates whether the operation was successful.

Errors