Segmentation by Tags
The Tag system allows dynamic labeling of users and organizations. These tags are fundamental for Access Policy Segmentation and the application of granular business rules, such as specific discounts or permissions at selected charging stations.
Data Scope
Tags and their links are strictly restricted to the Company of the authenticated user.
Listing and Creation
| Feature | Method | Path | Description |
|---|---|---|---|
| List Tags | GET | /tags | Returns the company's tags with member count. |
| Create Tag | POST | /tag | Registers a new active tag (requires name). |
Example Response (List)
{
"data": [
{
"id": 1,
"name": "Fleet-North",
"status": "active",
"users_count": 15
}
]
}
Link Management
Tags can be associated individually or to entire organizations for permission propagation.
POST /add-tag
Request Body
{
"tag_id": 1,
"direct_user_id": 123
}
Maintenance
- PUT
/tag/{id}— Update nomenclature. - PUT
/tag-inactivate/{id}— Toggle operational state of the tag.