API REST

Proyectos

Proyectos, resumen, cronograma, sprints, personas, color, ícono, repositorios y el panel.

GET /projects (tracker:read): proyectos con el tipo de proyecto (kind: software, design, admin o support, y el nombre en kind_label), tipos de issue (el nivel de cada uno y, cuando lo hay, el template, la plantilla de los campos de texto), flujo de estados, campos personalizados, etiquetas, módulos, el color del proyecto (color, #rrggbb) y el ícono (icon_url, con el mismo token, o null sin ícono: muestra el prefijo en una caja del color) y el inicio y el fin previstos (start_date, target_date, AAAA-MM-DD o null). Úsalo antes de crear issues.
GET /projects/{prefijo, slug o id} (tracker:read): el Resumen del proyecto, su primera pestaña en la pantalla. project (como en GET /projects), url, dates (start_date, target_date, days_elapsed desde el inicio, days_remaining hasta el fin, negativo cuando ya pasó, y time_progress, la fracción del tiempo previsto que ya pasó, de 0 a 1, con las dos fechas), issues (total, open, done, late), active_sprint (o null, con days_left), next_release (la de fecha planificada más cercana que todavía no salió, o null), late y upcoming (hasta 5 issues abiertas con el plazo vencido y con plazo por delante: code, title, due_date, assignee, url) y people (name, role). En el MCP: get_project.
POST /projects (tracker:write; quien configura algún proyecto, o admin): crea un proyecto, {"name": "App del conductor", "prefix": "MOB", "kind": "software", "workflow": "software_qa", "description": "...", "color": "verde", "library_icon": "carro", "start_date": "2026-11-03", "target_date": "2027-02-26"} (start_date y target_date, inicio y fin previstos, opcionales). kind: software (por defecto), design, admin o support; workflow (software): software_qa (por defecto), software o qa. Nombre y prefijo únicos en la empresa (422 cuando ya existen, incluso en la papelera). Quien crea entra como PO/PM. Devuelve project como en GET /projects (y warning si no se pudieron guardar el color o el ícono; inténtalo de nuevo con PATCH /projects/{ref}/brand). Crear a partir de otro proyecto queda en la app. En el MCP: create_project.
PATCH /projects/{prefijo, slug o id} (tracker:write; PO/PM o admin en el proyecto): inicio y fin previstos, {"start_date": "2026-11-03", "target_date": "2027-02-26"}; solo cambia lo que venga y null lo quita. El inicio no puede venir después del fin (422). Devuelve project, start_date y target_date. En el MCP: plan_project.
PATCH /projects/{prefijo, slug o id}/brand (tracker:write, PO/PM o admin en el proyecto): color e ícono; solo cambia lo que venga. JSON {"color": "verde", "library_icon": "carro-eletrico"}: color es un nombre de la paleta, en portugués (azul, violeta, rosa, vermelho, laranja, âmbar, verde, turquesa, grafite), o #rrggbb, y null vuelve al color automático; el ícono es uno de tres: library_icon (un ícono listo, pintado en el color del proyecto), image_base64 (un ícono propio, cuadrado, PNG, JPG o WebP hasta 2 MB; o multipart/form-data con la imagen en el campo icon y los demás campos en texto) o "remove_icon": true (vuelve al prefijo en la caja del color). El ícono listo se pinta en el momento: cambiar solo el color no lo vuelve a pintar, así que manda library_icon de nuevo junto con el color nuevo. En multipart, color vacío vuelve al automático. Devuelve color, color_chosen e icon_url. En el MCP: set_project_brand.
GET /project-icons (tracker:read): la biblioteca de los 108 íconos listos, por grupo, con slug, name y url (el dibujo en negro, fondo transparente); ?query=eletrico filtra por nombre, slug o grupo, sin tildes (los nombres están en portugués). En el MCP: list_project_icons.
GET /projects/{prefijo, slug o id}/people (tracker:read): personas activas del proyecto, con id y perfil. Úsalo para elegir al responsable.
GET /projects/{prefijo, slug o id}/sprints (tracker:read): la planificación del proyecto: sprints abiertos con las issues y los puntos, el comienzo del backlog (backlog.total y las primeras issues, en orden de prioridad) y la velocidad de los últimos sprints.
GET /projects/{prefijo, slug o id}/timeline (tracker:read): el Cronograma del proyecto. project (con start_date y target_date), url, can_plan (si la persona cambia las fechas de las issues), items (las issues con inicio o plazo, hasta 300, primero las abiertas y las de fecha más cercana a hoy: code, title, status, category, closed, group y group_kind, la épica o el módulo de la fila, is_epic, sprint, assignee, start_date, due_date, first_day y last_day de la barra, late, estimate_minutes, spent_minutes, url), truncated, dependencies (blocker, blocked y conflict, cuando la que bloquea termina el mismo día o después del inicio de la bloqueada), sprints, releases (con fecha planificada) y unscheduled (total y hasta 20 abiertas sin inicio ni plazo). Para cambiar fechas: PATCH /issues/{ref}/plan (la issue) y PATCH /projects/{ref} (el proyecto). En el MCP: get_timeline.
GET /projects/{prefijo, slug o id}/repositories (tracker:read): repositorios de GitHub y proyectos de GitLab conectados, con el estado que aplica cada evento, el último evento recibido y connection: github_app (la app de GitHub de la empresa), gitlab_token (tracker creó y mantiene el webhook en GitLab) o webhook (configurado a mano). Conectar y desconectar queda en la app.
GET /panel?project= (tracker:read): el panel de pared de un proyecto en una llamada (tablero, mesa de ayuda, releases, la semana, gráficos y aqua.topics, las preguntas listas de aqua, o null sin IA). GET /panel/aqua?project=&topic= (tracker:read): la respuesta de aqua a una de esas preguntas (overview, la de por defecto, attention, week, releases y support, esta solo en un proyecto con mesa de ayuda), en viñetas, con generated_at; la misma pregunta repite la respuesta durante 30 minutos.