> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mov-eat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview de APIs

> Explicación de alto nivel de las APIs de Moveat para operaciones y producto.

# Overview de APIs

Las APIs de Moveat no están pensadas hoy como integración pública para terceros. Existen para soportar la web app y Agent.

## Categorías

| Categoría     | Prefix                 | Consumidor | Propósito                       |
| ------------- | ---------------------- | ---------- | ------------------------------- |
| APIs públicas | `/v1`                  | Web app    | Acciones de usuario.            |
| APIs internas | `/internal/v1`         | Agent      | Operaciones service-to-service. |
| Health        | `/healthz`             | Infra      | Checks de uptime.               |
| Swagger       | `/docs`, `/agent-docs` | Ingeniería | Inspección de contratos.        |

## APIs públicas

Soportan auth, `/me`, onboarding, profile/context, channels, meals, weight y workouts. Autentican con sesión web.

## APIs internas

Soportan resolver usuario por canal, obtener contexto, registrar comidas, obtener resumen nutricional diario, registrar workouts y peso.

Autentican con internal service token.

## Modelo de errores

| Status | Significado                       |
| ------ | --------------------------------- |
| 400    | Payload inválido.                 |
| 401    | Sesión/token faltante o inválido. |
| 403    | No permitido.                     |
| 404    | Recurso no encontrado.            |
| 409    | Conflicto o estado incompleto.    |
| 429    | Rate limited.                     |
| 500    | Error inesperado.                 |

Swagger explica shapes exactos; esta documentación explica flujos y decisiones.