Skip to main content
POST
/
workspaces
/
{workspace}
/
contacts
/
{contact}
/
toggle-tag
Toggle Tag on Contact
curl --request POST \
  --url https://lancepilot.com/api/v3/workspaces/{workspace}/contacts/{contact}/toggle-tag \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tag_id": 1
}'
{
  "status": 200,
  "message": "Contact tag toggled successfully",
  "data": null
}

​
JSON Example

{
  "tag_id": 3
}

​
📝 Field Requirements

FieldTypeRequiredNotes
tag_idintegerYesID of the tag to toggle (must exist in workspace)

​
🔄 Behavior

This endpoint toggles a tag on a contact:
  • If the tag is not currently assigned to the contact, it will be added
  • If the tag is already assigned to the contact, it will be removed

​
✅ Success Response

{
  "status": 200,
  "message": "Contact tag toggled successfully",
  "data": null
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
workspace
string<uuid>
required

ID of the workspace.

​
contact
string<uuid>
required

ID of the contact.

Body

application/json
​
tag_id
integer
required

ID of the tag to toggle.

Response

Tag toggled successfully

​
status
integer
Example:

200

​
message
string
Example:

"Contact tag toggled successfully"

​
data
null