Skip to main content
POST
Assign or unassign tags to resources

Authorizations

Authorization
string
header
required

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

Body

application/json
tag_ids
string<uuid>[]
required

The list of tag ids to assign or unassign

Minimum array length: 1
resource_type
enum<number>
required

The resource type to assign or unassign the tags to

Available options:
1,
2
Example:

1

assign
boolean
required

Whether to assign the tags to the resources.

Example:

true

resource_ids
string[]

The list of resource ids to assign or unassign. A resource id is the id of an account or a campaign. Required unless selected_all is true.

Minimum array length: 1
excluded_resource_ids
string[]

Optional list of resource ids to exclude when selected_all is true.

Minimum array length: 1
selected_all
boolean

Whether to select all resources.

Example:

false

filter

Optional selected-all filter. Accepts the existing account-status string shape and the merged object shape for account status, tag, any-tag, all-tags, and search criteria.

Available options:
ACC_FILTER_PAUSED,
ACC_FILTER_ERROR,
ACC_FILTER_NO_CTD,
ACC_FILTER_PW_ACCOUNTS,
ACC_FILTER_DFY,
ACC_FILTER_DFY_SETUP_PENDING,
ACC_FILTER_W_ACTIVE,
ACC_FILTER_W_PAUSED,
ACC_FILTER_W_ERROR,
null
Example:

"ACC_FILTER_PAUSED"

Optional selected-all search query. If omitted, filter.search is used when present.

Example:

"jon@doe.com"

Response

Default Response

success
boolean
Example:

true