Modelos

Proyecto

En esta página

Campos

idstringobligatorio
namestringobligatorio
descriptionstring | nullobligatorio
colorstring | nullobligatorio
iconstring | nullobligatorio
tipoProjectTipo | nullobligatorio: Valores: trabajoociopersonal
statusProjectStatusobligatorio: Valores: activearchived
sharedbooleanobligatorio: Tiene al menos un miembro activo además del propietario/a.
rolestringobligatorio: Rol de la persona dueña de la key en el proyecto.
Valores: ownermember
createdAtnumberobligatorio
updatedAtnumberobligatorio

Siempre presentes: un campo sin valor llega como null; nunca se omite.
Fechas: createdAt y updatedAt son milisegundos desde 1970, en UTC.

Compartidos

shared es true si el proyecto tiene al menos un miembro además de su propietario.
role es tu papel en el proyecto: owner si es tuyo y member si te lo compartieron.

Cualquier miembro lee, edita y borra las tareas del proyecto, igual que en la app. Las invitaciones y los miembros se gestionan desde la app, no desde la API.

Archivados

Un proyecto con status: "archived" es de solo lectura: sus tareas se pueden leer, pero editarlas o borrarlas responde 409 project_archived. Filtra el listado con GET /projects?status=active si solo quieres los activos.

Crear

POST /projects solo pide name; description, color, icon y tipo (trabajo, ocio o personal) son opcionales. Es idempotente por nombre: si ya tienes un proyecto con ese nombre exacto, recibes el existente sin cambios.

GET /projects devuelve todos tus proyectos y los compartidos contigo, ordenados por nombre y sin paginar.