Ejecuciones de prueba

Una ejecución de prueba agrupa los resultados de tests para una sesión de ejecución específica (p. ej., una build de CI, un sprint o un pase de regresión manual).

Endpoints

Método	Ruta	Scope	Descripción
GET	/api/v1/runs	read	Listar ejecuciones de prueba
POST	/api/v1/runs	write	Crear una ejecución de prueba
GET	/api/v1/runs/{id}	read	Obtener una ejecución de prueba
PATCH	/api/v1/runs/{id}	write	Actualizar una ejecución de prueba

Listar ejecuciones de prueba

GET /api/v1/runs?project_id=clxyz123&status=COMPLETED
Authorization: Bearer qh_...

Parámetros de consulta

Parámetro	Tipo	Descripción
project_id	string	Filtrar por proyecto
status	string	PENDING, IN_PROGRESS, COMPLETED o SYNCED

Crear una ejecución de prueba

POST /api/v1/runs
Authorization: Bearer qh_...
Content-Type: application/json

{
  "name": "Sprint 24 regression — staging",
  "project_id": "clxyz123",
  "environment": "staging",
  "test_case_ids": ["clcase001", "clcase002", "TC-003"]
}

Campos

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre para mostrar de la ejecución
project_id	string	Sí	Proyecto al que asociar
environment	string	No	Etiqueta de entorno
test_case_ids	string[]	No	Prepoblar con casos de prueba específicos. Acepta cuid o código.

Actualizar una ejecución de prueba

PATCH /api/v1/runs/clrun001
Authorization: Bearer qh_...
Content-Type: application/json

{
  "status": "COMPLETED"
}

Campos actualizables: name, environment, status

Esquema del objeto ejecución

{
  "id": "string (cuid)",
  "name": "string",
  "project_id": "string",
  "environment": "string | null",
  "status": "PENDING | IN_PROGRESS | COMPLETED | SYNCED",
  "created_at": "ISO 8601 datetime",
  "updated_at": "ISO 8601 datetime"
}

Atajo para CI/CD

Para ingestar resultados de CI, usa el endpoint /api/v1/ingest en su lugar — crea la ejecución y rellena todos los resultados en una única solicitud.