Problemas
Lista problemas, lee uno con todo su contexto para arreglarlo, trae el prompt listo y márcalo como resuelto.
En esta página
- Estado
- El objeto problema
- El objeto análisis
- Listar problemas
- Traer un problema
- Traer el contexto de un problema
- Traer el prompt listo
- Traer la línea de tiempo de un problema
- Listar las sesiones que un problema afectó
- Resolver un problema
- Reabrir un problema
- Ignorar un problema
- Analizar un problema otra vez
- Abrir un pull request con el arreglo
Un problema es un grupo de fallas con una sola causa. El motor agrupa las fallas por huella a medida que llegan: un problema nuevo aparece, y puede generar una alerta, a menos de 2 minutos de su primer evento. Después el agente escribe el análisis (analysis), cuando hay un proveedor de IA configurado. Los conteos (occurrences, people, sessions) están completos en menos de 10 minutos.
Un problema tiene dos nombres. Su id (prb_…) nunca cambia. Su slug es legible (pay-button-does-nothing); al comienzo sale del título técnico y lo reemplaza una vez el primer análisis del agente. Todo endpoint que recibe un problema acepta el id, el slug actual o cualquier slug que el problema haya tenido antes.
Estado
| Estado | Qué significa | Cómo cambia |
|---|---|---|
open | Está pasando, o nadie ha dicho lo contrario | Es el estado inicial |
resolved | Alguien lo arregló | POST …/resolve. Si la falla vuelve, el problema se reabre solo y regressed pasa a true |
ignored | Conocido y aceptado. Nunca genera alertas y nunca se reabre | POST …/ignore |
El objeto problema
Campos
-
idstring opcionalEl id permanente,
prb_…. -
slugstring opcionalEl nombre legible. Único en el proyecto. Al comienzo sale del título, y lo reemplaza una vez el primer análisis del agente; los slugs anteriores siguen funcionando.
-
fingerprintstring opcionalLos 16 caracteres hexadecimales con los que el motor agrupa las fallas.
-
kindstring opcionalerror: una excepción.failed_call: una llamada que falló sin excepción, sea la llamada de la página a una API o la del servidor a una base de datos o a otro servicio. Una llamada falla cuando no recibe respuesta, responde400, o responde500o más.timeout: una petición que nunca terminó. -
originstring opcionalDónde ocurrió la falla. Una falla en el navegador y la falla que hay detrás en el servidor comparten una traza y son un solo problema: la más profunda es el problema, y lo que vio la persona es evidencia dentro de él. Uno de:
browser,server. -
statusstring opcionalMira la tabla de estados de arriba. Uno de:
open,resolved,ignored. -
regressedboolean opcionaltruecuando el problema se había resuelto y volvió. -
titlestring opcionalEl título técnico: el nombre y el mensaje del error, con los números y los ids reemplazados para que una causa sea un solo título.
-
environmentstring opcionalEl entorno donde ocurre. La misma falla en dos entornos son dos problemas.
-
routestring o null opcionalLa página o la ruta de la API donde más ocurre.
-
whereobject o null opcionalEl lugar de tu código. Sale del análisis cuando hay uno; si no, es el primer marco de tu propio código en la pila.
nullsin source maps o sin pila. -
first_seentimestamp opcionalLa primera falla.
-
last_seentimestamp opcionalLa falla más reciente.
-
first_releasestring o null opcionalLa versión de la primera falla.
-
last_releasestring o null opcionalLa versión de la falla más reciente.
-
occurrencesinteger opcionalCuántas veces ocurrió, en toda su vida.
-
peopleinteger opcionalA cuántas personas distintas afectó. Una persona identificada cuenta una vez aunque use varios dispositivos; un visitante anónimo cuenta por dispositivo.
-
sessionsinteger opcionalEn cuántas sesiones ocurrió.
-
resolved_attimestamp o null opcionalCuándo se resolvió por última vez. Queda como historia después de que vuelve.
-
resolved_bystring o null opcionalQuién lo resolvió:
token:<nombre>para un token de API,mcp:<nombre del token>por el servidor MCP,console, o en Sypnia Cloud el correo de una persona. -
resolved_in_releasestring o null opcionalLa versión que se dijo que trae el arreglo, si se dio una.
-
notestring o null opcionalLa nota que se dejó con el último cambio de estado.
-
analysisobject opcionalLo que el agente escribió sobre el problema. Mira Cómo funciona el análisis.
-
analysis.statusstringready: completo.pending: corriendo, casi siempre menos de un minuto.not_enough_evidence: el agente describió qué pasó y no nombró una causa, porque no la pudo sostener.failed: la llamada al modelo falló tres veces; se intenta de nuevo cuando el problema crece.limit_reached: el proyecto usó sus análisis de hoy.off: no hay proveedor de IA configurado, o el proyecto apagó el agente. -
analysis.sentencestring o nullQué pasó, en una o dos frases simples. Está cuando el estado es
readyonot_enough_evidence. -
analysis.whostring o nullA quién afectó.
-
analysis.doingstring o nullQué intentaban hacer.
-
analysis.sincestring o nullDesde cuándo, y si antes funcionaba.
-
analysis.causeobject o nullLa causa probable y en qué se apoya.
nullcuando el agente no encontró evidencia suficiente. -
analysis.cause.textstringLa causa, en palabras simples.
-
analysis.cause.evidencelista de objectDe uno a seis hechos, cada uno apuntando a algo que puedes abrir.
-
analysis.what_to_dostring o nullEl cambio que hay que hacer.
nullcuando no hay causa. -
analysis.confidencestring o nullQué tan bien sostiene la evidencia a la causa.
nullcuando no hay causa. Uno de:high,medium,low. -
analysis.generated_attimestamp o nullCuándo se escribió este análisis.
-
analysis.providerstring o nullEl proveedor de IA que lo corrió, como está configurado. En Sypnia Cloud,
openrouter. -
analysis.modelstring o nullEl modelo que lo corrió, como lo nombra el proveedor.
-
analysis.runsintegerCuántas veces se ha analizado el problema.
-
pull_requestobject o null opcionalSolo en Sypnia Cloud. El pull request que Sypnia abrió para este problema. Siempre
nullen un motor alojado por ti. -
urlURL opcionalEl problema en la app (Sypnia Cloud) o en la Consola (alojamiento propio).
-
created_attimestamp opcionalCuándo creó el motor el problema, a menos de 2 minutos de
first_seen.
El objeto análisis
Lo que el agente escribió sobre el problema. Mira Cómo funciona el análisis.
Campos
-
statusstring opcionalready: completo.pending: corriendo, casi siempre menos de un minuto.not_enough_evidence: el agente describió qué pasó y no nombró una causa, porque no la pudo sostener.failed: la llamada al modelo falló tres veces; se intenta de nuevo cuando el problema crece.limit_reached: el proyecto usó sus análisis de hoy.off: no hay proveedor de IA configurado, o el proyecto apagó el agente. -
sentencestring o null opcionalQué pasó, en una o dos frases simples. Está cuando el estado es
readyonot_enough_evidence. -
whostring o null opcionalA quién afectó.
-
doingstring o null opcionalQué intentaban hacer.
-
sincestring o null opcionalDesde cuándo, y si antes funcionaba.
-
causeobject o null opcionalLa causa probable y en qué se apoya.
nullcuando el agente no encontró evidencia suficiente. -
cause.textstringLa causa, en palabras simples.
-
cause.evidencelista de objectDe uno a seis hechos, cada uno apuntando a algo que puedes abrir.
-
cause.evidence[].kindstringQué tipo de hecho es. Uno de:
stack_frame,release_change,trace,breadcrumb,timing. -
cause.evidence[].refstringA qué apunta:
archivo:línea,versión:ruta, el id de una traza, la hora de un paso previo, el nombre de una versión. -
cause.evidence[].textstringEl hecho.
-
what_to_dostring o null opcionalEl cambio que hay que hacer.
nullcuando no hay causa. -
confidencestring o null opcionalQué tan bien sostiene la evidencia a la causa.
nullcuando no hay causa. Uno de:high,medium,low. -
generated_attimestamp o null opcionalCuándo se escribió este análisis.
-
providerstring o null opcionalEl proveedor de IA que lo corrió, como está configurado. En Sypnia Cloud,
openrouter. -
modelstring o null opcionalEl modelo que lo corrió, como lo nombra el proveedor.
-
runsinteger opcionalCuántas veces se ha analizado el problema.
Listar problemas
/v1/problems MotorNube Los problemas que se vieron en el rango de tiempo, con la actividad más reciente primero. Cada uno trae su análisis, así que una lista basta para responder «¿qué está fallando?». counts trae el número de problemas por estado con los mismos filtros, sin importar qué status pediste.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
environmentstring opcionalEl entorno que se lee. Cualquier nombre que el proyecto haya enviado, o
all.Por defecto:
production -
statusstring opcionalQué problemas devolver. Uno de:
open,resolved,ignored,all.Por defecto:
open -
kindstring opcionalerror(una excepción, en el navegador o en el servidor),failed_call(una llamada que falló sin excepción) otimeout(una petición que nunca terminó). -
releasestring opcionalSolo problemas vistos en esta versión.
-
routestring opcionalSolo problemas en esta página o ruta de la API, tal como Sypnia la normaliza (
/orders/:id). -
qstring, hasta 120 caracteres opcionalTexto que buscar en la frase, el título, el slug o el archivo. Hasta 120 caracteres.
-
sincestring opcionalSolo problemas vistos después de este momento.
Por defecto:
30d -
untilstring opcionalFin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
-
sortstring opcionallast_seen(actividad más reciente primero),first_seen(problema más nuevo primero),peopleuoccurrences(los mayores primero, contados en toda la vida del problema).Por defecto:
last_seen -
limitinteger, 1 a 200 opcionalMáximo de elementos que se devuelven.
Por defecto:
50 -
cursorstring opcionalEl
next_cursorde la página anterior. Deja iguales todos los demás parámetros.
Petición
curl "https://api.sypnia.com/v1/problems?status=open" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"data": [
{
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"fingerprint": "88a44b15205cb153",
"kind": "failed_call",
"origin": "server",
"status": "open",
"regressed": false,
"title": "createPayment answered 400 in POST /api/checkout",
"environment": "production",
"route": "/checkout",
"where": {
"file": "src/checkout/checkout.tsx",
"line": 142,
"function": "confirmPayment"
},
"first_seen": "2026-03-12T09:12:04Z",
"last_seen": "2026-03-12T10:31:47Z",
"first_release": "4f2a91c",
"last_release": "4f2a91c",
"occurrences": 5,
"people": 3,
"sessions": 3,
"resolved_at": null,
"resolved_by": null,
"resolved_in_release": null,
"note": null,
"analysis": {
"status": "ready",
"sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
"who": "3 people. Two of them tried again and gave up.",
"doing": "Paying for an order, at the last step of checkout.",
"since": "Yesterday's change, deployed at 18:40. It worked before.",
"cause": {
"text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
"evidence": [
{
"kind": "release_change",
"ref": "4f2a91c:src/cart/cart.ts",
"text": "The release renames `total` to `totalCents` in the Cart type."
},
{
"kind": "stack_frame",
"ref": "src/checkout/checkout.tsx:142",
"text": "confirmPayment() still passes `cart.total` to createPayment()."
},
{
"kind": "trace",
"ref": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"text": "POST /api/checkout answered 400 with the code `amount_required`."
},
{
"kind": "timing",
"ref": "4f2a91c",
"text": "No failure of this kind before the release went live. All 5 failures are on it."
}
]
},
"what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
"confidence": "high",
"generated_at": "2026-03-12T10:33:05Z",
"provider": "openrouter",
"model": "<model>",
"runs": 3
},
"pull_request": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing",
"created_at": "2026-03-12T09:13:02Z"
}
],
"counts": {
"open": 1,
"resolved": 4,
"ignored": 1
},
"next_cursor": null
}Traer un problema
/v1/problems/{problem} MotorNube El problema con su análisis. Para todo lo que necesita un arreglo (pila, pasos previos, traza, versión), pide su contexto.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Petición
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"fingerprint": "88a44b15205cb153",
"kind": "failed_call",
"origin": "server",
"status": "open",
"regressed": false,
"title": "createPayment answered 400 in POST /api/checkout",
"environment": "production",
"route": "/checkout",
"where": {
"file": "src/checkout/checkout.tsx",
"line": 142,
"function": "confirmPayment"
},
"first_seen": "2026-03-12T09:12:04Z",
"last_seen": "2026-03-12T10:31:47Z",
"first_release": "4f2a91c",
"last_release": "4f2a91c",
"occurrences": 5,
"people": 3,
"sessions": 3,
"resolved_at": null,
"resolved_by": null,
"resolved_in_release": null,
"note": null,
"analysis": {
"status": "ready",
"sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
"who": "3 people. Two of them tried again and gave up.",
"doing": "Paying for an order, at the last step of checkout.",
"since": "Yesterday's change, deployed at 18:40. It worked before.",
"cause": {
"text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
"evidence": [
{
"kind": "release_change",
"ref": "4f2a91c:src/cart/cart.ts",
"text": "The release renames `total` to `totalCents` in the Cart type."
},
{
"kind": "stack_frame",
"ref": "src/checkout/checkout.tsx:142",
"text": "confirmPayment() still passes `cart.total` to createPayment()."
},
{
"kind": "trace",
"ref": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"text": "POST /api/checkout answered 400 with the code `amount_required`."
},
{
"kind": "timing",
"ref": "4f2a91c",
"text": "No failure of this kind before the release went live. All 5 failures are on it."
}
]
},
"what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
"confidence": "high",
"generated_at": "2026-03-12T10:33:05Z",
"provider": "openrouter",
"model": "<model>",
"runs": 3
},
"pull_request": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing",
"created_at": "2026-03-12T09:13:02Z"
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
Traer el contexto de un problema
/v1/problems/{problem}/context MotorNube Todo lo que una persona o un agente de código necesita para arreglar el problema, en una sola respuesta: el problema y su análisis, la pila con las líneas de tu propio código, lo que hizo la persona antes de la falla, la traza de la petición que falló, la versión y lo que cambió en ella, a quién afectó y sesiones para mirar.
La pila, los pasos previos y la traza salen de una ocurrencia, nombrada en sample: la más reciente que tenga traza y grabación, o si no la más reciente. Pasa session para armar el contexto con otra sesión.
Una parte que no existe es null y aparece en missing, con la razón, para que quien llama nunca tenga que adivinar por qué falta algo: source_maps_not_uploaded, no_trace, release_unknown, expired.
Son los mismos datos que lee el agente, antes de limpiarlos. Es lo que devuelve la herramienta MCP problem.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
sessionstring opcionalArma la pila, los pasos previos y la traza con la ocurrencia de esta sesión en vez de la que se toma por defecto.
-
breadcrumbsinteger, 0 a 100 opcionalCuántos eventos anteriores a la falla devolver.
Por defecto:
30 -
source_linesinteger, 0 a 20 opcionalLíneas de código que devolver alrededor de cada marco de tu propio código, a cada lado.
Por defecto:
5
Petición
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/context" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"problem": {
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"…": "the whole problem object, as in «Get a problem»"
},
"sample": {
"session_id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"at": "2026-03-12T10:31:47Z",
"trace_id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"release": "4f2a91c",
"browser": "Chrome 134",
"os": "macOS",
"device": "desktop"
},
"stack": {
"origin": "browser",
"error": {
"name": "ApiError",
"message": "POST /api/checkout failed with 400 (amount_required)"
},
"symbolicated": true,
"frames": [
{
"function": "createPayment",
"file": "src/lib/api.ts",
"line": 27,
"column": 11,
"in_app": true,
"source": {
"start_line": 25,
"lines": [
" const res = await fetch('/api/checkout', { method: 'POST', body: JSON.stringify(input) });",
" if (!res.ok) {",
" throw new ApiError('POST', '/api/checkout', res.status, await errorCode(res));",
" }",
" return res.json();"
]
}
},
{
"function": "confirmPayment",
"file": "src/checkout/checkout.tsx",
"line": 142,
"column": 21,
"in_app": true,
"source": {
"start_line": 140,
"lines": [
"async function confirmPayment(cart: Cart) {",
" setPaying(true);",
" const payment = await createPayment({ amount: cart.total, currency: cart.currency });",
" router.push(`/orders/${payment.orderId}`);",
"}"
]
}
},
{
"function": "onClick",
"file": "src/checkout/pay-button.tsx",
"line": 18,
"column": 5,
"in_app": true,
"source": {
"start_line": 17,
"lines": [
" <button type=\"submit\" disabled={paying} onClick={() => confirmPayment(cart)}>",
" Pay {formatMoney(cart)}",
" </button>"
]
}
}
],
"raw": "ApiError: POST /api/checkout failed with 400 (amount_required)\n at createPayment (https://shop.example.com/assets/checkout-3f9c.js:1:48211)\n at async confirmPayment (https://shop.example.com/assets/checkout-3f9c.js:1:51377)\n at async onClick (https://shop.example.com/assets/checkout-3f9c.js:1:52904)"
},
"breadcrumbs": [
{
"at": "2026-03-12T10:31:28.412Z",
"offset_ms": 12412,
"type": "page_view",
"route": "/checkout",
"text": "Opened /checkout (from /cart)",
"data": {
"navigation": "push",
"from": "/cart"
},
"trace_id": null,
"problem_id": null
},
{
"at": "2026-03-12T10:31:43.090Z",
"offset_ms": 27090,
"type": "click",
"route": "/checkout",
"text": "Clicked button «Pay $64.00» in «Your order»",
"data": {
"selector": "#pay-button",
"role": "button",
"label": "Pay $64.00",
"context": "Your order",
"href": null
},
"trace_id": null,
"problem_id": null
},
{
"at": "2026-03-12T10:31:45.310Z",
"offset_ms": 29310,
"type": "rage_click",
"route": "/checkout",
"text": "Clicked button «Pay $64.00» 4 more times",
"data": {
"selector": "#pay-button",
"role": "button",
"label": "Pay $64.00",
"context": "Your order",
"count": 4
},
"trace_id": null,
"problem_id": null
},
{
"at": "2026-03-12T10:31:47.000Z",
"offset_ms": 31000,
"type": "request",
"route": "/checkout",
"text": "POST /api/checkout answered 400 amount_required after 3,870 ms",
"data": {
"method": "POST",
"path": "/api/checkout",
"status": 400,
"duration_ms": 3870,
"code": "amount_required",
"message": "amount is required"
},
"trace_id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"problem_id": null
}
],
"trace": {
"id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"…": "the whole trace with its spans, as in «Get a trace»"
},
"release": {
"version": "4f2a91c",
"…": "the whole release with its changes, as in «Get a release»"
},
"impact": {
"people": 3,
"sessions": 3,
"occurrences": 5,
"people_who_retried": 2,
"by_release": {
"4f2a91c": 5
},
"by_browser": {
"Chrome 134": 3,
"Safari 18": 2
},
"by_device": {
"desktop": 3,
"mobile": 2
},
"last_success_before": "2026-03-11T17:52:30Z"
},
"sessions": [
{
"id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"started_at": "2026-03-12T10:31:16Z",
"duration_ms": 42000,
"person": {
"id": "u_1042",
"name": "Ada Park",
"email": "ada@example.com"
},
"has_replay": true,
"occurrences": 1,
"first_occurrence_at": "2026-03-12T10:31:47Z",
"url": "https://app.sypnia.com/shop/sessions/8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0?at=31000"
}
],
"missing": [],
"links": {
"prompt": "/v1/problems/prb_8f3k2m9x4q7w/prompt",
"problem": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
}
}Errores
- 404
not_foundNingún problema tiene este id o slug, o
sessionno es una sesión de este problema.
Traer el prompt listo
/v1/problems/{problem}/prompt MotorNube El prompt para pegar en un agente de código. Siempre existe. Con un análisis dice qué pasa, dónde, por qué, qué hacer y cómo comprobarlo. Sin uno (no hay proveedor de IA, o no hay evidencia suficiente) lleva la evidencia y le pide al agente de código que encuentre la causa. Su estructura es fija y está documentada en El prompt. Tiene como máximo 12.000 caracteres.
Pide format=text, o envía Accept: text/plain, para recibir solo el prompt en texto plano.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
formatstring opcionaljsonenvuelve el prompt con sus datos.textdevuelve solo el prompt, comotext/plain.Por defecto:
json
Petición
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/prompt?format=text" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"problem_id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"analysis_status": "ready",
"generated_at": "2026-03-12T10:33:05Z",
"chars": 2648,
"prompt": "Fix a production bug reported by Sypnia.\n\nWhat happens: clicking Pay does nothing. 3 people hit it today (2026-03-12),\n since release 4f2a91c (deployed 2026-03-11 18:40 UTC).\nWhere: src/checkout/checkout.tsx:142, confirmPayment()\nWhy: that release renamed cart.total to cart.totalCents, but\n checkout.tsx still reads cart.total. The payment goes out\n with amount undefined and the API answers 400.\n Confidence: high.\nDo: read cart.totalCents in confirmPayment(), and show the\n customer a message when a payment is rejected.\nCheck: session 8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0 shows the clicks.\n Add a test that fails when the amount is missing.\n\n… (the evidence and the rules follow; the full text is on the page «The prompt»)"
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
Traer la línea de tiempo de un problema
/v1/problems/{problem}/timeline MotorNube Cada cuánto ocurrió el problema a lo largo del tiempo, y los momentos que explican la curva: cuándo se vio por primera vez, qué versiones salieron, cuándo se analizó, se resolvió o se reabrió. Los intervalos sin nada vuelven con ceros, así la serie no tiene huecos.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
sincestring opcionalInicio de la serie.
Por defecto:
14d -
untilstring opcionalFin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
-
intervalstring opcionalTamaño de cada intervalo.
hourse permite en rangos de hasta 7 días. Los días se cortan en la zona horaria del proyecto.Por defecto:
day
Petición
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/timeline?since=2d&interval=day" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"interval": "day",
"timezone": "UTC",
"buckets": [
{
"start": "2026-03-11T00:00:00Z",
"occurrences": 0,
"people": 0,
"sessions": 0
},
{
"start": "2026-03-12T00:00:00Z",
"occurrences": 5,
"people": 3,
"sessions": 3
}
],
"markers": [
{
"at": "2026-03-11T18:40:00Z",
"type": "release",
"release": "4f2a91c"
},
{
"at": "2026-03-12T09:12:04Z",
"type": "first_seen"
},
{
"at": "2026-03-12T09:13:40Z",
"type": "analysis",
"confidence": "medium"
},
{
"at": "2026-03-12T10:33:05Z",
"type": "analysis",
"confidence": "high"
}
]
}Errores
- 400
invalid_requestinterval=hourcon un rango de más de 7 días. - 404
not_foundNingún problema del proyecto tiene este id o slug.
Listar las sesiones que un problema afectó
/v1/problems/{problem}/sessions MotorNube Las sesiones en las que ocurrió el problema, la más reciente primero. Cada una es un objeto sesión con dos campos más: occurrences, cuántas veces ocurrió en esa sesión, y first_occurrence_at, el momento al que saltar en la grabación. El motor guarda hasta 200 ids de sesión por problema y por día; people y sessions del problema siguen siendo exactos.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403. -
sincestring opcionalSolo sesiones posteriores a este momento.
Por defecto:
30d -
untilstring opcionalFin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
-
has_replayboolean opcionaltruedevuelve solo las sesiones que tienen grabación. -
limitinteger, 1 a 200 opcionalMáximo de elementos que se devuelven.
Por defecto:
50 -
cursorstring opcionalEl
next_cursorde la página anterior. Deja iguales todos los demás parámetros.
Petición
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/sessions" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"data": [
{
"id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"started_at": "2026-03-12T10:31:16Z",
"ended_at": "2026-03-12T10:31:58Z",
"duration_ms": 42000,
"person": {
"id": "u_1042",
"name": "Ada Park",
"email": "ada@example.com"
},
"account": {
"id": "acc_77",
"name": "Corner Café"
},
"environment": "production",
"release": "4f2a91c",
"device": "desktop",
"browser": "Chrome 134",
"os": "macOS",
"locale": "en-US",
"entry_route": "/cart",
"routes": [
"/cart",
"/checkout"
],
"page_views": 2,
"clicks": 7,
"rage_clicks": 1,
"dead_clicks": 0,
"errors": 1,
"requests": 6,
"failed_requests": 1,
"trouble": true,
"has_replay": true,
"url": "https://app.sypnia.com/shop/sessions/8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
"occurrences": 1,
"first_occurrence_at": "2026-03-12T10:31:47Z"
},
{
"id": "2b7d9e4f1a6c4830b5d2f7e9c1a3b5d7",
"started_at": "2026-03-12T09:47:40Z",
"ended_at": "2026-03-12T09:49:02Z",
"duration_ms": 82000,
"person": {
"id": "u_0977",
"name": null,
"email": null
},
"account": null,
"environment": "production",
"release": "4f2a91c",
"device": "mobile",
"browser": "Safari 18",
"os": "iOS",
"locale": "en-US",
"entry_route": "/checkout",
"routes": [
"/checkout"
],
"page_views": 1,
"clicks": 4,
"rage_clicks": 0,
"dead_clicks": 0,
"errors": 2,
"requests": 5,
"failed_requests": 2,
"trouble": true,
"has_replay": true,
"url": "https://app.sypnia.com/shop/sessions/2b7d9e4f1a6c4830b5d2f7e9c1a3b5d7",
"occurrences": 2,
"first_occurrence_at": "2026-03-12T09:48:11Z"
},
{
"id": "c4e1a8f3d7b24c69a0e5d3b1f9c7a5e3",
"started_at": "2026-03-12T09:11:26Z",
"ended_at": "2026-03-12T09:13:15Z",
"duration_ms": 109000,
"person": null,
"account": null,
"environment": "production",
"release": "4f2a91c",
"device": "desktop",
"browser": "Chrome 134",
"os": "Windows",
"locale": "en-GB",
"entry_route": "/",
"routes": [
"/",
"/products/:id",
"/cart",
"/checkout"
],
"page_views": 4,
"clicks": 11,
"rage_clicks": 0,
"dead_clicks": 0,
"errors": 2,
"requests": 14,
"failed_requests": 2,
"trouble": true,
"has_replay": true,
"url": "https://app.sypnia.com/shop/sessions/c4e1a8f3d7b24c69a0e5d3b1f9c7a5e3",
"occurrences": 2,
"first_occurrence_at": "2026-03-12T09:12:04Z"
}
],
"next_cursor": null
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
Resolver un problema
/v1/problems/{problem}/resolve MotorNube Marca el problema como arreglado. Si la falla vuelve a ocurrir, el problema se reabre solo, regressed pasa a true y se crea una alerta, así que resolver antes de tiempo no es un riesgo.
Pasa release cuando sepas qué versión trae el arreglo. Entonces las fallas de versiones anteriores, como una pestaña del navegador que estaba abierta antes del despliegue, no reabren el problema; solo lo reabre una falla en esa versión o en una posterior.
Resolver un problema ya resuelto no cambia nada y responde 200.
Basta un token read: resolver es una marca reversible, que queda registrada con el nombre del token en resolved_by.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
releasestring, hasta 40 caracteres opcionalLa versión que trae el arreglo. Las fallas de versiones anteriores a ella no reabren el problema.
-
notestring, hasta 500 caracteres opcionalEl porqué, para quien lea el problema después.
Petición
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/resolve" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"release": "5b3c8d2", "note": "Fixed in pull request 128."}'Respuesta200
{
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"fingerprint": "88a44b15205cb153",
"kind": "failed_call",
"origin": "server",
"status": "resolved",
"regressed": false,
"title": "createPayment answered 400 in POST /api/checkout",
"environment": "production",
"route": "/checkout",
"where": {
"file": "src/checkout/checkout.tsx",
"line": 142,
"function": "confirmPayment"
},
"first_seen": "2026-03-12T09:12:04Z",
"last_seen": "2026-03-12T10:31:47Z",
"first_release": "4f2a91c",
"last_release": "4f2a91c",
"occurrences": 5,
"people": 3,
"sessions": 3,
"resolved_at": "2026-03-12T11:20:44Z",
"resolved_by": "token:Cursor",
"resolved_in_release": "5b3c8d2",
"note": "Fixed in pull request 128.",
"analysis": {
"status": "ready",
"sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
"who": "3 people. Two of them tried again and gave up.",
"doing": "Paying for an order, at the last step of checkout.",
"since": "Yesterday's change, deployed at 18:40. It worked before.",
"cause": {
"text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
"evidence": [
{
"kind": "release_change",
"ref": "4f2a91c:src/cart/cart.ts",
"text": "The release renames `total` to `totalCents` in the Cart type."
},
{
"kind": "stack_frame",
"ref": "src/checkout/checkout.tsx:142",
"text": "confirmPayment() still passes `cart.total` to createPayment()."
},
{
"kind": "trace",
"ref": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"text": "POST /api/checkout answered 400 with the code `amount_required`."
},
{
"kind": "timing",
"ref": "4f2a91c",
"text": "No failure of this kind before the release went live. All 5 failures are on it."
}
]
},
"what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
"confidence": "high",
"generated_at": "2026-03-12T10:33:05Z",
"provider": "openrouter",
"model": "<model>",
"runs": 3
},
"pull_request": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing",
"created_at": "2026-03-12T09:13:02Z"
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
- 409
conflictEl problema está en
ignored. Reábrelo primero.
Reabrir un problema
/v1/problems/{problem}/reopen MotorNube Devuelve a open un problema resuelto o ignorado. Reabrir un problema abierto no cambia nada y responde 200.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
notestring, hasta 500 caracteres opcionalEl porqué, para quien lea el problema después.
Petición
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/reopen" \
-H "Authorization: Bearer $SYPNIA_API_TOKEN"Respuesta200
{
"id": "prb_8f3k2m9x4q7w",
"slug": "pay-button-does-nothing",
"fingerprint": "88a44b15205cb153",
"kind": "failed_call",
"origin": "server",
"status": "open",
"regressed": false,
"title": "createPayment answered 400 in POST /api/checkout",
"environment": "production",
"route": "/checkout",
"where": {
"file": "src/checkout/checkout.tsx",
"line": 142,
"function": "confirmPayment"
},
"first_seen": "2026-03-12T09:12:04Z",
"last_seen": "2026-03-12T10:31:47Z",
"first_release": "4f2a91c",
"last_release": "4f2a91c",
"occurrences": 5,
"people": 3,
"sessions": 3,
"resolved_at": null,
"resolved_by": null,
"resolved_in_release": null,
"note": null,
"analysis": {
"status": "ready",
"sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
"who": "3 people. Two of them tried again and gave up.",
"doing": "Paying for an order, at the last step of checkout.",
"since": "Yesterday's change, deployed at 18:40. It worked before.",
"cause": {
"text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
"evidence": [
{
"kind": "release_change",
"ref": "4f2a91c:src/cart/cart.ts",
"text": "The release renames `total` to `totalCents` in the Cart type."
},
{
"kind": "stack_frame",
"ref": "src/checkout/checkout.tsx:142",
"text": "confirmPayment() still passes `cart.total` to createPayment()."
},
{
"kind": "trace",
"ref": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
"text": "POST /api/checkout answered 400 with the code `amount_required`."
},
{
"kind": "timing",
"ref": "4f2a91c",
"text": "No failure of this kind before the release went live. All 5 failures are on it."
}
]
},
"what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
"confidence": "high",
"generated_at": "2026-03-12T10:33:05Z",
"provider": "openrouter",
"model": "<model>",
"runs": 3
},
"pull_request": null,
"url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing",
"created_at": "2026-03-12T09:13:02Z"
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
Ignorar un problema
/v1/problems/{problem}/ignore MotorNube Marca el problema como conocido y aceptado. Un problema ignorado sigue contando, nunca genera alertas, no se vuelve a analizar y nunca se reabre solo. Como silencia alertas, necesita el permiso admin.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Cuerpo
-
notestring, hasta 500 caracteres opcionalEl porqué, para quien lea el problema después.
Petición
curl -X POST "https://api.sypnia.com/v1/problems/prb_2c7n5v1b9m3k/ignore" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"note": "Open tabs after a deploy. Accepted for now."}'Respuesta200
{
"id": "prb_2c7n5v1b9m3k",
"slug": "search-page-part-does-not-load",
"fingerprint": "51d0a9c3e7f2b846",
"kind": "error",
"origin": "browser",
"status": "ignored",
"regressed": false,
"title": "TypeError: Failed to fetch dynamically imported module",
"environment": "production",
"route": "/search",
"where": null,
"first_seen": "2026-03-02T14:20:11Z",
"last_seen": "2026-03-11T18:44:30Z",
"first_release": "2e6b0f4",
"last_release": "9c1e7b2",
"occurrences": 212,
"people": 41,
"sessions": 57,
"resolved_at": null,
"resolved_by": null,
"resolved_in_release": null,
"note": "Open tabs after a deploy. Accepted for now.",
"analysis": {
"status": "not_enough_evidence",
"sentence": "41 people could not load part of the search page. It happens in the minutes after a deploy.",
"who": "41 people who had the page open while a new release went live.",
"doing": "Browsing search results.",
"since": "First seen on 2 March. It comes back with every release.",
"cause": null,
"what_to_do": null,
"confidence": null,
"generated_at": "2026-03-02T14:21:02Z",
"provider": "openrouter",
"model": "<model>",
"runs": 2
},
"pull_request": null,
"url": "https://app.sypnia.com/shop/problems/search-page-part-does-not-load",
"created_at": "2026-03-02T14:20:58Z"
}Errores
- 403
forbiddenEl token no tiene el permiso
admin. - 404
not_foundNingún problema del proyecto tiene este id o slug.
Analizar un problema otra vez
/v1/problems/{problem}/analyze MotorNube Le pide al agente que analice el problema ahora, con la evidencia más nueva. El agente ya corre por su cuenta cuando un problema es nuevo, cuando crece y cuando vuelve; usa esto después de subir source maps o de registrar la versión, que le dan más que leer. La respuesta llega de inmediato con analysis.status en pending; lee el problema otra vez, o escucha el webhook problem.analyzed, para tener el resultado.
Cuenta contra el límite diario de análisis.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Parámetros de consulta
-
projectstring opcionalEl id o el slug del proyecto. Solo hace falta con una credencial que ve varios proyectos (el token raíz). Con un token de API se ignora, salvo que nombre otro proyecto, que es
403.
Encabezados
-
Idempotency-Keystring, hasta 255 caracteres opcionalUn valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira idempotencia.
Petición
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/analyze" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta202
{
"problem_id": "prb_8f3k2m9x4q7w",
"analysis": {
"status": "pending"
},
"analyses_left_today": 46
}Errores
- 404
not_foundNingún problema del proyecto tiene este id o slug.
- 409
ai_not_configuredEl motor no tiene proveedor de IA (
SYPNIA_AI_PROVIDEResnone), o el proyecto apagó el agente. - 409
conflictEl problema está en
ignored, o ya hay un análisis suyo corriendo. - 429
analysis_limit_reachedEl proyecto usó sus análisis de hoy.
Retry-Afterdice cuándo se reinicia la cuenta.
Abrir un pull request con el arreglo
/v1/problems/{problem}/pull-request Nube Le pide a la GitHub App de Sypnia que escriba el arreglo y abra un pull request. Es el botón «Abrir pull request» de la app. La respuesta llega de inmediato; el pull request aparece en el problema (pull_request) en pocos minutos, y se envía un webhook problem.pull_request_opened.
Sypnia nunca hace merge. Mira Pull requests para saber qué trae el pull request y qué puede hacer la GitHub App.
Un motor alojado por ti no tiene este endpoint: responde 404 cloud_only. Usa el prompt o el servidor MCP con tu propio agente de código.
Parámetros de ruta
-
problemstring obligatorioEl id del problema (
prb_…) o su slug, actual o anterior.
Encabezados
-
Idempotency-Keystring, hasta 255 caracteres opcionalUn valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira idempotencia.
Petición
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/pull-request" \
-H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"Respuesta202
{
"problem_id": "prb_8f3k2m9x4q7w",
"pull_request": {
"state": "queued",
"branch": "sypnia/pay-button-does-nothing",
"repository": "acme/shop",
"number": null,
"url": null,
"opened_at": null
},
"fixes_left_this_month": 44
}Errores
- 404
cloud_onlyLa petición llegó a un motor alojado por ti.
- 409
github_not_connectedEl proyecto no tiene un repositorio conectado por la GitHub App de Sypnia.
- 409
not_enough_evidenceFalta el análisis, o su confianza es
low, o no encontró una causa. Sypnia no escribe un arreglo que no puede justificar. - 409
pull_request_existsEl problema ya tiene un pull request abierto. Su URL está en el
messagedel error y enpull_requestdel problema. - 429
fixes_limit_reachedLa organización usó los pull requests de este mes. Mira Límites.
Los errores que cualquier endpoint puede responder (401, 403, 429, 500, 503) están en Errores, límites, paginación.