Ir al contenido
BordioBordio Documentation

Etiquetas

Las etiquetas son marcas a nivel de workspace referenciadas por las tareas mediante tag_ids. La API expone CRUD completo:

Método Ruta
GET /tags Lista las etiquetas del workspace (paginación por cursor)
GET /tags/{id} Una etiqueta
POST /tags Crear — cuerpo { "name": "…" }
PATCH /tags/{id} Renombrar — cuerpo { "name": "…" }
DELETE /tags/{id} Eliminar — ver el interruptor de seguridad abajo

Las etiquetas no están ligadas a un proyecto, así que las claves de ámbito de proyecto trabajan con ellas igual que las claves de workspace. Una etiqueta fuera del workspace de tu clave devuelve 404 not_found_error.

Eliminar una etiqueta: el interruptor force

Sección titulada «Eliminar una etiqueta: el interruptor force»

Eliminar una etiqueta también la quita de todas las tareas que la llevan — por eso la API protege contra hacerlo por accidente.

Por defecto (force omitido o false): si la etiqueta está vinculada a alguna tarea, la solicitud se rechaza:

Terminal window
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 }
  }
}

Usa details.linked_tasks_count de forma programática — por ejemplo, para mostrar un diálogo de confirmación. Las tareas eliminadas no cuentan; las archivadas sí. Si la etiqueta no está vinculada a nada, la eliminación procede de inmediato.

Con force=true: la etiqueta se elimina incondicionalmente y se quita de todas las tareas vinculadas:

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

La desvinculación es asíncrona: durante un breve momento tras la eliminación, los listados de tareas pueden seguir devolviendo la etiqueta eliminada en tag_ids.

Para ver de antemano a qué tareas está vinculada una etiqueta, usa el filtro de tareas: GET /tasks?tag_id=… (ver Filtrado de tareas).