# Referencia de la API

> La API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.

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/

Para agentes: Índice de la referencia de la API HTTP de Sypnia. URL base https://api.sypnia.com/v1 (alojamiento propio: <URL base>/v1). Empieza por Resumen y autenticación; las convenciones están en Errores, límites, paginación. El contrato es spec/openapi.yaml.

**\[Motor]** **\[Nube]** Todo lo que Sypnia sabe de tu app está en esta API: los problemas con su causa, las sesiones y sus grabaciones, las trazas, el rendimiento, la disponibilidad, las alertas. La app, la Consola, el servidor MCP y la CLI están hechos sobre ella, así que todo lo que muestran lo puede leer tu propio código.

Es la misma API en un motor alojado por ti y en Sypnia Cloud. Un endpoint que existe solo en uno lo dice con una insignia.

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

|              |                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| URL base     | `https://api.sypnia.com/v1` en Sypnia Cloud, `<tu URL base>/v1` en tu motor                                                     |
| Credenciales | Un token de API (`sps_…`) para leer y administrar; una llave de ingesta (`spk_…`) para enviar; el token raíz en tu propio motor |
| Formato      | JSON de entrada y de salida. Fechas en UTC                                                                                      |
| Contrato     | `spec/openapi.yaml` en el repositorio de la documentación, OpenAPI 3.1. Estas páginas se generan a partir de él                 |

Los nombres de endpoints, parámetros, campos y valores están en inglés y no se traducen. Los ejemplos de respuestas muestran los datos tal como los devuelve la API.

## Empieza aquí

## Leer

## Enviar y administrar
