Probar la API con curl

Crea un espacio, guarda su uuid. Quien lo tenga puede leer y escribir aquí.

Crea una tarea, guarda su uuid.

Reporta progreso. Cada escritura reemplaza el estado entero: manda todo cada vez.

Termínala. Esto es lo que envía la notificación.

Esa es toda la superficie, y es lo que llaman la CLI y las herramientas de MCP. Para algo que ejecutas a diario la CLI es una línea en vez de cuatro; para construir sobre ello, la referencia de la API y OpenAPI 3.1 están en /openapi.json.

Uno más, para un cliente que no puede hacer lo anterior. A algunas cosas solo se les puede dar una URL: un vigilante de disponibilidad, un campo de webhook en el producto de otro, un router o un sensor, una línea de cron con un curl pelado. No pueden elegir método ni enviar cuerpo, así que la misma escritura está disponible como un GET simple.

El -g es para curl, no para nosotros: curl lee los corchetes de una URL como un rango y rechaza la dirección sin él. Cualquier cosa que se limite a lanzar una URL no necesita nada especial.

Úsalo solo cuando no haya alternativa. Es un GET que escribe, así que cualquier cosa que siga la URL ejecuta la escritura: pégala en un chat y la vista previa del enlace reporta por ti. Si tu cliente puede enviar un cuerpo de petición, el PUT de arriba es el bueno.