Skip to main content

​
PUTa tag

PUT /user-api/v1/tags/:id

​
Headers

HeaderValue
Content-Typeapplication/json
x-rolodex-api-keyf1e2d3c4b5a697...

​
Path Parameters

​
id
string
Tag ID

​
Query Parameters

​
include
string
Related data to include: contacts, companies, tasks

​
Endpoint Example

PUT /user-api/v1/tags/tag_99999?include=contacts
Relationship fields (contacts, companies, tasks) are replaced entirely with the provided values. To add to existing relationships, include all current values plus new ones.

​
Request

{
  "name": "Premium Client",
  "contacts": ["contact_123"]
}

​
Response

{
  "data": {
    "id": "tag_99999",
    "name": "Premium Client",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T12:45:00Z"
  }
}