Remove tags from contact

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "address": {},
  "createdAt": "2026-01-15T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "interests": [
    "healthcare",
    "scheduling"
  ],
  "language": "en",
  "name": "Jane Smith",
  "primaryPhone": "+15551234567",
  "secondaryPhones": [
    "+15559876543",
    "+15558765432"
  ],
  "tags": [
    "vip",
    "priority"
  ],
  "updatedAt": "2026-01-15T10:30:00Z",
  "company": "Acme Corp",
  "deletedAt": "2024-01-15T09:30:00Z",
  "email": "jane@example.com",
  "lastContactedAt": "2024-01-15T09:30:00Z",
  "notes": "string",
  "occupation": "Product Manager",
  "timezone": "America/New_York"
}

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

contactIdstringRequiredformat: "uuid"

Contact ID

Request

This endpoint expects an object.

tagslist of stringsRequired

Tags to remove from the contact (1-50 tags)

Response

Tags removed, updated contact returned

accountIdstringformat: "uuid"

Account that owns this contact

addressobject

Structured address (street, city, state, zip, country)

createdAtdatetime

Timestamp when the contact was created

idstringformat: "uuid"

Unique identifier for the contact

interestslist of strings

Contact interests or topics

languagestring

BCP 47 language code

namestring

Full name of the contact

primaryPhonestring

Primary phone number in E.164 format

secondaryPhoneslist of strings

Additional phone numbers in E.164 format

tagslist of strings

Tags for categorization and filtering

updatedAtdatetime

Timestamp when the contact was last updated

companystring or nullOptional

Company or organization name

deletedAtdatetime or nullOptional

Timestamp when the contact was soft-deleted, if applicable

emailstring or nullOptional

Email address

lastContactedAtdatetime or nullOptional

Timestamp of the most recent call with this contact

notesstring or nullOptional

Free-text notes about the contact

occupationstring or nullOptional

Job title or occupation

timezonestring or nullOptional

IANA timezone identifier

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error