# Problemas

> Lista problemas, lee uno con todo su contexto para arreglarlo, trae el prompt listo y márcalo como resuelto.

Aplica a: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/api/problems/

Para agentes: Referencia de los endpoints de problemas de la API de Sypnia: listar, traer, contexto completo, prompt, línea de tiempo, sesiones afectadas, resolver, reabrir, ignorar, analizar otra vez y pull request (Cloud).

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:**

- `id` (string, opcional): El id permanente, `prb_…`.
- `slug` (string, opcional): El 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.
- `fingerprint` (string, opcional): Los 16 caracteres hexadecimales con los que el motor agrupa las fallas.
- `kind` (string, opcional): `error`: 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, responde `400`, o responde `500` o más. `timeout`: una petición que nunca terminó.
- `origin` (string, opcional): Dó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`.
- `status` (string, opcional): Mira la tabla de estados de arriba. Uno de: `open`, `resolved`, `ignored`.
- `regressed` (boolean, opcional): `true` cuando el problema se había resuelto y volvió.
- `title` (string, opcional): El 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.
- `environment` (string, opcional): El entorno donde ocurre. La misma falla en dos entornos son dos problemas.
- `route` (string o null, opcional): La página o la ruta de la API donde más ocurre.
- `where` (object o null, opcional): El 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. `null` sin source maps o sin pila.
- `first_seen` (timestamp, opcional): La primera falla.
- `last_seen` (timestamp, opcional): La falla más reciente.
- `first_release` (string o null, opcional): La versión de la primera falla.
- `last_release` (string o null, opcional): La versión de la falla más reciente.
- `occurrences` (integer, opcional): Cuántas veces ocurrió, en toda su vida.
- `people` (integer, opcional): A cuántas personas distintas afectó. Una persona identificada cuenta una vez aunque use varios dispositivos; un visitante anónimo cuenta por dispositivo.
- `sessions` (integer, opcional): En cuántas sesiones ocurrió.
- `resolved_at` (timestamp o null, opcional): Cuándo se resolvió por última vez. Queda como historia después de que vuelve.
- `resolved_by` (string o null, opcional): Quié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_release` (string o null, opcional): La versión que se dijo que trae el arreglo, si se dio una.
- `note` (string o null, opcional): La nota que se dejó con el último cambio de estado.
- `analysis` (object, opcional): Lo que el agente escribió sobre el problema. Mira [Cómo funciona el análisis](https://docs.sypnia.com/es/agent/how-the-analysis-works).
- `analysis.status` (string): `ready`: 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.sentence` (string o null): Qué pasó, en una o dos frases simples. Está cuando el estado es `ready` o `not_enough_evidence`.
- `analysis.who` (string o null): A quién afectó.
- `analysis.doing` (string o null): Qué intentaban hacer.
- `analysis.since` (string o null): Desde cuándo, y si antes funcionaba.
- `analysis.cause` (object o null): La causa probable y en qué se apoya. `null` cuando el agente no encontró evidencia suficiente.
- `analysis.cause.text` (string): La causa, en palabras simples.
- `analysis.cause.evidence` (lista de object): De uno a seis hechos, cada uno apuntando a algo que puedes abrir.
- `analysis.what_to_do` (string o null): El cambio que hay que hacer. `null` cuando no hay causa.
- `analysis.confidence` (string o null): Qué tan bien sostiene la evidencia a la causa. `null` cuando no hay causa. Uno de: `high`, `medium`, `low`.
- `analysis.generated_at` (timestamp o null): Cuándo se escribió este análisis.
- `analysis.provider` (string o null): El proveedor de IA que lo corrió, como está configurado. En Sypnia Cloud, `openrouter`.
- `analysis.model` (string o null): El modelo que lo corrió, como lo nombra el proveedor.
- `analysis.runs` (integer): Cuántas veces se ha analizado el problema.
- `pull_request` (object o null, opcional): Solo en Sypnia Cloud. El pull request que Sypnia abrió para este problema. Siempre `null` en un motor alojado por ti.
- `url` (URL, opcional): El problema en la app (Sypnia Cloud) o en la Consola (alojamiento propio).
- `created_at` (timestamp, opcional): Cuá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](https://docs.sypnia.com/es/agent/how-the-analysis-works).

**Campos:**

- `status` (string, opcional): `ready`: 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.
- `sentence` (string o null, opcional): Qué pasó, en una o dos frases simples. Está cuando el estado es `ready` o `not_enough_evidence`.
- `who` (string o null, opcional): A quién afectó.
- `doing` (string o null, opcional): Qué intentaban hacer.
- `since` (string o null, opcional): Desde cuándo, y si antes funcionaba.
- `cause` (object o null, opcional): La causa probable y en qué se apoya. `null` cuando el agente no encontró evidencia suficiente.
- `cause.text` (string): La causa, en palabras simples.
- `cause.evidence` (lista de object): De uno a seis hechos, cada uno apuntando a algo que puedes abrir.
- `cause.evidence[].kind` (string): Qué tipo de hecho es. Uno de: `stack_frame`, `release_change`, `trace`, `breadcrumb`, `timing`.
- `cause.evidence[].ref` (string): A 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[].text` (string): El hecho.
- `what_to_do` (string o null, opcional): El cambio que hay que hacer. `null` cuando no hay causa.
- `confidence` (string o null, opcional): Qué tan bien sostiene la evidencia a la causa. `null` cuando no hay causa. Uno de: `high`, `medium`, `low`.
- `generated_at` (timestamp o null, opcional): Cuándo se escribió este análisis.
- `provider` (string o null, opcional): El proveedor de IA que lo corrió, como está configurado. En Sypnia Cloud, `openrouter`.
- `model` (string o null, opcional): El modelo que lo corrió, como lo nombra el proveedor.
- `runs` (integer, opcional): Cuántas veces se ha analizado el problema.

## Listar problemas

`GET /v1/problems` \[Motor, Nube]

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.

**Autenticación:** Token de API (`read`)

**Parámetros de consulta:**

- `project` (string, opcional): El 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`.
- `environment` (string, opcional, por defecto `production`): El entorno que se lee. Cualquier nombre que el proyecto haya enviado, o `all`.
- `status` (string, opcional, por defecto `open`): Qué problemas devolver. Uno de: `open`, `resolved`, `ignored`, `all`.
- `kind` (string, opcional): `error` (una excepción, en el navegador o en el servidor), `failed_call` (una llamada que falló sin excepción) o `timeout` (una petición que nunca terminó).
- `release` (string, opcional): Solo problemas vistos en esta versión.
- `route` (string, opcional): Solo problemas en esta página o ruta de la API, tal como Sypnia la normaliza (`/orders/:id`).
- `q` (string, hasta 120 caracteres, opcional): Texto que buscar en la frase, el título, el slug o el archivo. Hasta 120 caracteres.
- `since` (string, opcional, por defecto `30d`): Solo problemas vistos después de este momento.
- `until` (string, opcional): Fin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
- `sort` (string, opcional, por defecto `last_seen`): `last_seen` (actividad más reciente primero), `first_seen` (problema más nuevo primero), `people` u `occurrences` (los mayores primero, contados en toda la vida del problema).
- `limit` (integer, 1 a 200, opcional, por defecto `50`): Máximo de elementos que se devuelven.
- `cursor` (string, opcional): El `next_cursor` de la página anterior. Deja iguales todos los demás parámetros.

**Petición:**

```bash
curl "https://api.sypnia.com/v1/problems?status=open" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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

`GET /v1/problems/{problem}` \[Motor, Nube]

El problema con su análisis. Para todo lo que necesita un arreglo (pila, pasos previos, traza, versión), pide su contexto.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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:**

```bash
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema del proyecto tiene este id o slug.

## Traer el contexto de un problema

`GET /v1/problems/{problem}/context` \[Motor, Nube]

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`.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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`.
- `session` (string, opcional): Arma la pila, los pasos previos y la traza con la ocurrencia de esta sesión en vez de la que se toma por defecto.
- `breadcrumbs` (integer, 0 a 100, opcional, por defecto `30`): Cuántos eventos anteriores a la falla devolver.
- `source_lines` (integer, 0 a 20, opcional, por defecto `5`): Líneas de código que devolver alrededor de cada marco de tu propio código, a cada lado.

**Petición:**

```bash
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/context" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema tiene este id o slug, o `session` no es una sesión de este problema.

## Traer el prompt listo

`GET /v1/problems/{problem}/prompt` \[Motor, Nube]

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](https://docs.sypnia.com/es/agent/the-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.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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`.
- `format` (string, opcional, por defecto `json`): `json` envuelve el prompt con sus datos. `text` devuelve solo el prompt, como `text/plain`.

**Petición:**

```bash
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/prompt?format=text" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema del proyecto tiene este id o slug.

## Traer la línea de tiempo de un problema

`GET /v1/problems/{problem}/timeline` \[Motor, Nube]

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.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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`.
- `since` (string, opcional, por defecto `14d`): Inicio de la serie.
- `until` (string, opcional): Fin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
- `interval` (string, opcional, por defecto `day`): Tamaño de cada intervalo. `hour` se permite en rangos de hasta 7 días. Los días se cortan en la zona horaria del proyecto.

**Petición:**

```bash
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/timeline?since=2d&interval=day" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_request`: `interval=hour` con un rango de más de 7 días.
- `404` `not_found`: Ningún problema del proyecto tiene este id o slug.

## Listar las sesiones que un problema afectó

`GET /v1/problems/{problem}/sessions` \[Motor, Nube]

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.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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`.
- `since` (string, opcional, por defecto `30d`): Solo sesiones posteriores a este momento.
- `until` (string, opcional): Fin del rango de tiempo. Una fecha ISO 8601 o un valor relativo. Por defecto, ahora.
- `has_replay` (boolean, opcional): `true` devuelve solo las sesiones que tienen grabación.
- `limit` (integer, 1 a 200, opcional, por defecto `50`): Máximo de elementos que se devuelven.
- `cursor` (string, opcional): El `next_cursor` de la página anterior. Deja iguales todos los demás parámetros.

**Petición:**

```bash
curl "https://api.sypnia.com/v1/problems/pay-button-does-nothing/sessions" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema del proyecto tiene este id o slug.

## Resolver un problema

`POST /v1/problems/{problem}/resolve` \[Motor, Nube]

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`.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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:**

- `release` (string, hasta 40 caracteres, opcional): La versión que trae el arreglo. Las fallas de versiones anteriores a ella no reabren el problema.
- `note` (string, hasta 500 caracteres, opcional): El porqué, para quien lea el problema después.

**Petición:**

```bash
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."}'
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema del proyecto tiene este id o slug.
- `409` `conflict`: El problema está en `ignored`. Reábrelo primero.

## Reabrir un problema

`POST /v1/problems/{problem}/reopen` \[Motor, Nube]

Devuelve a `open` un problema resuelto o ignorado. Reabrir un problema abierto no cambia nada y responde `200`.

**Autenticación:** Token de API (`read`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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:**

- `note` (string, hasta 500 caracteres, opcional): El porqué, para quien lea el problema después.

**Petición:**

```bash
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/reopen" \
  -H "Authorization: Bearer $SYPNIA_API_TOKEN"
```

**Respuesta (200):**

```json
{
  "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_found`: Ningún problema del proyecto tiene este id o slug.

## Ignorar un problema

`POST /v1/problems/{problem}/ignore` \[Motor, Nube]

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`.

**Autenticación:** Token de API (`admin`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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:**

- `note` (string, hasta 500 caracteres, opcional): El porqué, para quien lea el problema después.

**Petición:**

```bash
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."}'
```

**Respuesta (200):**

```json
{
  "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` `forbidden`: El token no tiene el permiso `admin`.
- `404` `not_found`: Ningún problema del proyecto tiene este id o slug.

## Analizar un problema otra vez

`POST /v1/problems/{problem}/analyze` \[Motor, Nube]

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.

**Autenticación:** Token de API (`admin`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Parámetros de consulta:**

- `project` (string, opcional): El 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-Key` (string, hasta 255 caracteres, opcional): Un valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira [idempotencia](https://docs.sypnia.com/es/api/errors-limits-pagination#idempotency).

**Petición:**

```bash
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/analyze" \
  -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
```

**Respuesta (202):**

```json
{
  "problem_id": "prb_8f3k2m9x4q7w",
  "analysis": {
    "status": "pending"
  },
  "analyses_left_today": 46
}
```

**Errores:**

- `404` `not_found`: Ningún problema del proyecto tiene este id o slug.
- `409` `ai_not_configured`: El motor no tiene proveedor de IA (`SYPNIA_AI_PROVIDER` es `none`), o el proyecto apagó el agente.
- `409` `conflict`: El problema está en `ignored`, o ya hay un análisis suyo corriendo.
- `429` `analysis_limit_reached`: El proyecto usó sus análisis de hoy. `Retry-After` dice cuándo se reinicia la cuenta.

## Abrir un pull request con el arreglo

`POST /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](https://docs.sypnia.com/es/agent/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.

**Autenticación:** Token de API (`admin`)

**Parámetros de ruta:**

- `problem` (string, obligatorio): El id del problema (`prb_…`) o su slug, actual o anterior.

**Encabezados:**

- `Idempotency-Key` (string, hasta 255 caracteres, opcional): Un valor tuyo, de 1 a 255 caracteres, que hace que la llamada se pueda repetir sin riesgo. Mira [idempotencia](https://docs.sypnia.com/es/api/errors-limits-pagination#idempotency).

**Petición:**

```bash
curl -X POST "https://api.sypnia.com/v1/problems/pay-button-does-nothing/pull-request" \
  -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
```

**Respuesta (202):**

```json
{
  "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_only`: La petición llegó a un motor alojado por ti.
- `409` `github_not_connected`: El proyecto no tiene un repositorio conectado por la GitHub App de Sypnia.
- `409` `not_enough_evidence`: Falta 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_exists`: El problema ya tiene un pull request abierto. Su URL está en el `message` del error y en `pull_request` del problema.
- `429` `fixes_limit_reached`: La organización usó los pull requests de este mes. Mira [Límites](https://docs.sypnia.com/es/agent/limits).

Los errores que cualquier endpoint puede responder (`401`, `403`, `429`, `500`, `503`) están en [Errores, límites, paginación](https://docs.sypnia.com/es/api/errors-limits-pagination).
