Skip to main content
PATCH
/
tag
/
{tagId}
/
profiles
Update profiles of tag by ID.
curl --request PATCH \
  --url https://vanguard.profilebehavior.com/api/v4/tag/{tagId}/profiles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "profiles": [
    "507f191e810c19729de860ea"
  ]
}
'
{
  "code": 200,
  "tag": {
    "label": "Staff",
    "color": "emerald",
    "profiles": [
      "6592008029c8c3e4dc76256c",
      "507f191e810c19729de860ea"
    ]
  },
  "status": "success"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
tagId
string
required

The ID of the tag to update profiles for.

Body

application/json

The properties to be assigned to the tag.

​
profiles
string[]
required

An array of profile IDs to be associated with the tag.

Response

Success

Standard response object for successful single-resource requests in the Profile Behavior API. Contains an HTTP status code, the returned resource data, and a status indicator.

​
code
integer<int32>
required

HTTP status code of the successful response.

​
status
enum<string>

Always "success" for successful responses.

Available options:
success
​
tag
object

Base schema that provides unique identification and timestamp metadata for resources in the Profile Behavior API.

Represents a tag used for organizing profiles, teams, or groups within an account. Tags allow for flexible grouping, filtering, and analytics across individuals and teams.