Теги

Теги — метки уровня workspace, на которые задачи ссылаются через tag_ids. API даёт полный CRUD:

Метод	Путь
GET	/tags	Список тегов workspace (курсорная пагинация)
GET	/tags/{id}	Один тег
POST	/tags	Создать — тело { "name": "…" }
PATCH	/tags/{id}	Переименовать — тело { "name": "…" }
DELETE	/tags/{id}	Удалить — см. предохранитель ниже

Теги не привязаны к проекту, поэтому project-scoped ключи работают с ними так же, как workspace-ключи. Тег вне workspace вашего ключа → 404 not_found_error.

Удаление тега: предохранитель force

Удаление тега снимает его со всех задач, где он висит, — поэтому API защищает от случайного удаления.

По умолчанию (force не передан или false): если тег связан хотя бы с одной задачей, запрос отклоняется:

curl -X DELETE "https://api.bordio.com/public/v1/tags/tag_65dcc9c66f2e4e001ab18859" \
  -H "Authorization: Bearer brd_sk_live_..."

{
  "error": {
    "type": "conflict_error",
    "code": "tag_in_use",
    "message": "Tag is linked to 7 task(s). Pass force=true to delete it anyway.",
    "details": { "linked_tasks_count": 7 }
  }
}

Используйте details.linked_tasks_count программно — например, для диалога подтверждения. Удалённые задачи не считаются; архивные — считаются. Если тег ни с чем не связан, удаление проходит сразу.

С force=true: тег удаляется безусловно и снимается со всех связанных задач:

curl -X DELETE "https://api.bordio.com/public/v1/tags/tag_65dcc9c66f2e4e001ab18859?force=true" \
  -H "Authorization: Bearer brd_sk_live_..."

Отвязка асинхронная: короткое время после удаления листинги задач могут ещё отдавать удалённый тег в tag_ids.

Чтобы заранее посмотреть, с какими задачами связан тег, используйте фильтр задач: GET /tasks?tag_id=… (см. Фильтрацию задач).