Eliminar y restaurar

Eliminar una tarea o un evento por la API no es definitivo. El registro pasa a la papelera, donde permanece 30 días y puede restaurarse — por ti desde la API o por cualquier persona del workspace desde la aplicación web.

Método	Ruta
DELETE	/tasks/{id}	Enviar una tarea a la papelera
GET	/tasks/trash	Lista de tareas eliminadas (paginación por cursor)
POST	/tasks/{id}/restore	Recuperar una tarea
DELETE	/scheduled-events/{id}	Enviar un evento a la papelera
GET	/scheduled-events/trash	Lista de eventos eliminados
POST	/scheduled-events/{id}/restore	Recuperar un evento

Eliminar requiere tasks:write o events:write; leer la papelera requiere el permiso :read correspondiente. El registro eliminado desaparece de inmediato del resto de listados y de los informes: la papelera es el único sitio donde sigue siendo visible.

Listar la papelera

curl "https://api.bordio.com/public/v1/tasks/trash" \
  -H "Authorization: Bearer brd_sk_live_..."

{
  "data": [
    {
      "id": "task_65dcc9c66f2e4e001ab18859",
      "object": "task",
      "title": "Aprobar el nuevo diseño",
      "project_id": "proj_65dcc9c66f2e4e001ab18801",
      "deleted_at": "2026-09-01T10:00:00.000Z",
      "expires_at": "2026-10-01T10:00:00.000Z",
      "deleted_by": "user_65dcc9c66f2e4e001ab18802"
    }
  ],
  "pagination": { "next_cursor": null, "has_more": false }
}

expires_at es el momento en que el registro sale de la papelera. A partir de ahí desaparece para siempre y restore responde 404. El resto del registro — descripción, campos personalizados, comentarios — no está en este listado: léelo con un GET normal cuando lo hayas recuperado.

En la papelera ves exactamente lo mismo que en cualquier otro sitio. Un proyecto al que no tienes acceso no aporta nada, y una clave limitada a un proyecto solo ve el suyo. Cuando un asistente o una aplicación actúa en tu nombre, tu rol en el workspace también debe permitir gestionar la papelera; de lo contrario, tanto el listado como la restauración se rechazan.

Restaurar

curl -X POST "https://api.bordio.com/public/v1/tasks/task_65dcc9c66f2e4e001ab18859/restore" \
  -H "Authorization: Bearer brd_sk_live_..."

La respuesta es la tarea completa, igual que la devolvería GET /tasks/{id}.

Conviene saber de antemano:

• Restaurar dos veces responde 404. Un registro recuperado ya no está en la papelera, así que no hay nada que restaurar. Trata el 404 como «ya restaurado o caducado», no como un fallo de tu código.
• El proyecto debe seguir existiendo. Una tarea cuyo proyecto se eliminó no puede recuperarse hasta que se recupere el proyecto: la petición responde 400.
• Una repetición no vuelve como repetición. Eliminar una ocurrencia la desvincula de la serie y vuelve como registro suelto. Eliminar la serie entera (?scope=all) elimina también la regla de repetición, y eso no tiene vuelta atrás.
• La tarea restaurada vuelve al final de su columna, no a la posición que ocupaba antes.
• Comentarios y adjuntos vuelven con el registro. El tiempo registrado en la tarea también.

Eliminación permanente

No existe en la API. Los registros salen de la papelera solos a los 30 días, o cuando alguien los elimina definitivamente en la aplicación web. Ninguna llamada de aquí destruye un registro al instante.

Archivar un proyecto

Los proyectos no se eliminan por la API. Cuando un proyecto termina, se archiva: desaparece del workspace sin tocar nada de su contenido y puede recuperarse en cualquier momento.

Método	Ruta
POST	/projects/{id}/archive	Archivar
POST	/projects/{id}/unarchive	Desarchivar

curl -X POST "https://api.bordio.com/public/v1/projects/proj_65dcc9c66f2e4e001ab18801/archive" \
  -H "Authorization: Bearer brd_sk_live_..."

Ambas requieren projects:write y ambas devuelven el proyecto. Archivar un proyecto ya archivado responde 400, igual que desarchivar uno que no lo está.

Los proyectos archivados siguen en GET /projects con archived_at relleno. Para acotar la lista está el parámetro archived:

curl "https://api.bordio.com/public/v1/projects?archived=false" \
  -H "Authorization: Bearer brd_sk_live_..."

Sin el parámetro llegan ambos, como antes.

Las tareas y los eventos dentro de un proyecto archivado no se eliminan ni aparecen en la papelera.