ื“ืœื’ ืœืชื•ื›ืŸ ื”ืจืืฉื™

Tags & Skills Endpoints

API endpoints for Tags and Skills management.

Tagsโ€‹

Tags provide flexible categorization across all entities.

# List tags
GET /api/tags?organizationId=xxx

# Create tag
POST /api/tags
{
  "name": "Urgent",
  "color": "#FF0000",
  "description": "High-priority items",
  "organizationId": "org-uuid"
}

# Update tag
PUT /api/tags/:id
{
  "name": "Critical",
  "color": "#CC0000"
}

# Delete tag
DELETE /api/tags/:id

Tag Typesโ€‹

# List tag types
GET /api/tag-types

# Tag types define which entities a tag can apply to
POST /api/tag-types
{
  "type": "task",
  "organizationId": "org-uuid"
}

Tagging Entitiesโ€‹

Tags can be applied to many entity types:

EntityHow to Tag
TasksPUT /api/tasks/:id with tags array
EmployeesPUT /api/employee/:id with tags array
ProjectsPUT /api/organization-projects/:id with tags array
InvoicesPUT /api/invoices/:id with tags array
ExpensesPUT /api/expense/:id with tags array

Skillsโ€‹

Skills are used for employee profiles and candidate matching.

# List skills
GET /api/skills?organizationId=xxx

# Create skill
POST /api/skills
{
  "name": "TypeScript",
  "description": "TypeScript programming language",
  "color": "#3178C6",
  "organizationId": "org-uuid"
}

# Update skill
PUT /api/skills/:id

# Delete skill
DELETE /api/skills/:id

Assigning Skills to Employeesโ€‹

PUT /api/employee/:id
{
  "skills": [
    { "id": "skill-uuid-1" },
    { "id": "skill-uuid-2" }
  ]
}