API — Etiquetas

Endpoints para gerenciar labels no nível de workspace.

Base path: /api/v1/workspaces/:workspace_slug

---

POST /workspaces/:slug/labels

Cria uma etiqueta no workspace. Requer papel member ou superior.

Body

{
  "name": "frontend",
  "color": "#3b82f6"
}

name deve ser único no workspace. color deve ser um hex válido.

Response 201

{
  "id": "01J8X...",
  "name": "frontend",
  "color": "#3b82f6",
  "workspace_id": "01J8X...",
  "created_at": "2026-04-18T12:00:00Z"
}

Exemplo

curl -X POST https://tasks.cloudface.tech/api/v1/workspaces/produto/labels \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name": "frontend", "color": "#3b82f6"}'

---

GET /workspaces/:slug/labels

Lista todas as etiquetas do workspace.

Response 200

{
  "labels": [
    {
      "id": "01J8X...",
      "name": "frontend",
      "color": "#3b82f6",
      "issue_count": 17
    },
    {
      "id": "01J8X...",
      "name": "backend",
      "color": "#10b981",
      "issue_count": 34
    }
  ]
}

---

PATCH /workspaces/:slug/labels/:id

Atualiza uma etiqueta. Requer member ou superior.

Body

{
  "name": "web-frontend",
  "color": "#06b6d4"
}

A mudança reflete automaticamente em todas as issues que usam a etiqueta.

Response 200 — etiqueta atualizada

---

DELETE /workspaces/:slug/labels/:id

Deleta uma etiqueta e remove a associação em todas as issues. Requer admin ou owner.

A operação é irreversível. Issues que usavam a etiqueta ficam sem ela.

Response 204 — sem body