انتقل إلى المحتوى الرئيسي

Tag Endpoints

Manage tags for flexible entity categorization.

Base Path​

/api/tag

Endpoints​

List Tags​

GET /api/tag
Authorization: Bearer {token}

Query Parameters:

ParameterTypeDescription
namestringFilter by name
colorstringFilter by color

Response:

{
  "items": [
    { "id": "uuid", "name": "Urgent", "color": "#FF0000", "isSystem": false },
    { "id": "uuid", "name": "Frontend", "color": "#61DAFB", "isSystem": false }
  ],
  "total": 15
}

Create Tag​

POST /api/tag
Authorization: Bearer {token}
{
  "name": "Backend",
  "color": "#68A063",
  "description": "Backend related items"
}

Update Tag​

PUT /api/tag/:id
Authorization: Bearer {token}

Delete Tag​

DELETE /api/tag/:id
Authorization: Bearer {token}

Get Tag Usage​

GET /api/tag/:id/count
Authorization: Bearer {token}

Returns count of entities using this tag.

Taggable Entities​

Tags can be applied to: Tasks, Employees, Projects, Contacts, Invoices, Expenses, Equipment, Proposals.