Etiquetas
Etiquetas aplicadas a recursos.
Listar etiquetas
Lista as etiquetas de um tipo de alvo, informado obrigatoriamente em `filter` por `target_kind`; para `demand` o filtro também exige `scope_id` (o workflow). Requer a permissão de leitura do tipo: `identity.companies.read`, `requests.demands.read` ou `platform.organizations.read`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Criar etiqueta
Cria uma etiqueta com `target_kind`, `name` (até 40 caracteres) e `color` no formato `#RRGGBB`; etiquetas de `demand` exigem `scope_id` (workflow) e as demais não o aceitam. Requer `identity.companies.create` ou `identity.companies.update` (empresas), `requests.demands.transition` ou `requests.workflows.manage` (demandas), ou `platform.organizations.manage` (organizações). Nome repetido no mesmo escopo retorna `409`.
Atualizar etiqueta
Altera `name` e/ou `color` da etiqueta (`tag_id` é UUID); corpo vazio retorna `400` e etiqueta inexistente `404`. Requer `identity.companies.update`, `requests.demands.transition` ou `platform.organizations.manage`, conforme o tipo da etiqueta. Nome repetido retorna `409`.
Excluir etiqueta
Exclui a etiqueta (`tag_id` é UUID) e todas as suas atribuições; responde `204`. Requer `identity.companies.delete`, `requests.workflows.manage` ou `platform.organizations.manage`, conforme o tipo da etiqueta. Etiqueta inexistente retorna `404`.
Substituir etiquetas de um item
Define a lista completa de etiquetas (`tag_ids`, até 20) de um item identificado por `target_kind` e `target_id`, substituindo as anteriores, e devolve as etiquetas resultantes. Requer `identity.companies.update`, `requests.demands.transition` ou `platform.organizations.manage`, conforme o tipo. Etiqueta de outro tipo ou de outro workflow retorna `404`; mais de 20 retorna `400`.