Assign or unassign a tag

Toggle the assignment status of one or more custom tags for specific resources, either assigning or unassigning the custom tags as required.

For resource_type 1 (ACCOUNT), only email addresses are accepted. For resource_type 2 (CAMPAIGN), only UUIDs are accepted. Please ensure your input matches the corresponding format based on the resource_type specified.

Heads up! if you are still unsure about what resource_type to use, you should check this guide first

Query Parameters

api_keystring Required

Your API Key

Body Parameters

tag_idsarray Required

Specifies the unique identifiers of the tags to be assigned or unassigned to the resources.

Show child attributes

resource_typenumber Required

Resource Type

Enum values:
1
Use 1 for ACCOUNTS
2
Use 2 for CAMPAIGNS
resource_idsarray Required

The IDs of the resources to assign or unassign the tags to.

Show child attributes

assignboolean Required

Specifies whether to assign (true) or unassign (false) the tags to the resources. If not provided, the default value is true.

Response

200
Object
Successfully assigned the tags to the resources.

Response Attributes

successboolean
messagestring
200
Object
Successfully unassigned the tags to the resources.

Response Attributes

successboolean
messagestring
400
Object
Bad Request

Response Attributes

statusCodenumber

Request code

errorstring

Error type

messagestring

Error messag

404
Object
Not found

Response Attributes

statusCodenumber

Status code

errorstring

Error type

messagestring

Error message

Was this section helpful?

What made this section unhelpful for you?

Language Box

POST

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?