Pistas

Utilice puntos finales de seguimiento para el trabajo activo.

Crear una tarea

POST /v1/tracks
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "type": "task",
  "title": "Review docs",
  "scope": { "type": "personal" },
  "task": { "status": "todo", "dueDate": "2026-06-05" }
}

Crea una meta

{
	"type": "goal",
	"title": "Ship documentation v1",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"goal": { "status": "on_track", "progress": 40 }
}

Buscar

Los filtros de tareas incluyen status, assignee, goalId, parentId, dependsOn y rangos de fechas. Los filtros de objetivos incluyen status, progressMin, progressMax y rangos de fechas.

Cuando type es task, los filtros de solo objetivos como progressMin y progressMax no son válidos. Cuando type es goal, los filtros de solo tareas como assignee, goalId, parentId y dependsOn no son válidos.

Utilice los resultados de la búsqueda para limitar el conjunto de objetivos antes de buscar pistas individuales.

Solicitud masiva

{
	"scope": { "type": "personal" },
	"upserts": [
		{ "id": "t001", "title": "Task A", "task": { "status": "todo" } },
		{ "id": "t002", "title": "Task B", "task": { "status": "todo", "dependsOn": ["t001"] } }
	]
}

Los identificadores que no son UUID crean nuevos registros. Los ID de UUID actualizan los registros existentes.

En upserts, el tipo se infiere de task o goal. Pasar ambos no es válido. Las pistas nuevas requieren title; Los identificadores UUID mantienen los campos omitidos sin cambios.

Revisar

POST /v1/tracks/review
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "targetIds": ["task-or-goal-id"],
  "instruction": "Focus on what should change in the source workflow pack."
}

Genera una revisión de solo lectura para una o más tareas u objetivos. La respuesta devuelve un objeto review que contiene stats y Markdown generado content para revisiones detalladas:

{
	"targets": [{ "id": "task-or-goal-id", "title": "Review docs", "entityType": "task" }],
	"review": {
		"stats": {
			"relatedTaskCount": 4,
			"doneTaskCount": 2,
			"logCount": 5,
			"sourceCount": 2
		},
		"content": "## Summary\n..."
	}
}

Las revisiones detalladas consumen créditos según el uso del token de IA. Las estadísticas ligeras de review devueltas por las actualizaciones del estado de la pista son gratuitas.

Consulte Logs para agregar, enumerar (una pista o en cada pista) y eliminar registros de actividad/comentarios.