Tags on a Prospect

Method	Path	Description
`GET`	`/v1/prospects/{id}/tags`	The catalog with an `assigned` flag
`PUT`	`/v1/prospects/{id}/tags`	Replace the prospect's tags with `tag_ids`
`POST`	`/v1/prospects/{id}/tags/{tag_id}`	Add one tag
`DELETE`	`/v1/prospects/{id}/tags/{tag_id}`	Remove one tag

body tag_idsarrayrequired

For PUT: the exact set of tag IDs to keep. An empty array clears them.

Request example

1234curl -X PUT "https://api.v2.dealmachine.com/v1/prospects/prospect_8812/tags" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "tag_ids": ["tag_1", "tag_4"] }'

Response example

12345678910{
  "data": {
    "tags": [
      { "id": "tag_1", "name": "Hot", "badge_variant": "destructive", "is_system": true, "assigned": true },
      { "id": "tag_4", "name": "Follow up", "badge_variant": "default", "is_system": true, "assigned": true }
    ],
    "added": ["tag_4"],
    "removed": []
  }
}