# MI AI Manifest

> Logistics management platform: pallets, shipments, containers, billing, fleet, multi-stop, AI chat (TLI). Full bilingual (EN, es-MX).

## For AI agents — start here

The canonical MI stack reference (architecture, schema, conventions, endpoints, agents) lives at:

- [MI Stack reference — canonical](https://apps.mi2.com.mx/stack) — owned by the MI Coolify Apps platform
- [MI Stack reference — JSON](https://apps.mi2.com.mx/stack/version.json)

The MI AI Manifest External API is open to integrators. Authenticate with a Bearer token (issued by an admin from Settings → API Keys & External API) and call /api/v1/external/* endpoints.

## Frozen v3.22.1 snapshot (deprecated)

These endpoints still serve the historical JSON shape with a deprecation notice attached:

- [/api/public/stack](https://manifest.miglobal.com.mx/api/public/stack)
- [/stack.json](https://manifest.miglobal.com.mx/stack.json)
- [/stack.md](https://manifest.miglobal.com.mx/stack.md)

## API

- [OpenAPI 3.1 spec](https://manifest.miglobal.com.mx/api/docs/openapi.json)
- [Interactive API reference (Scalar)](https://manifest.miglobal.com.mx/api/docs)
- [External API getting-started guide](https://manifest.miglobal.com.mx/docs/guides/EXTERNAL_API_GUIDE.md)
- [External API endpoint reference](https://manifest.miglobal.com.mx/docs/guides/EXTERNAL_API_REFERENCE.md)
- [Webhooks guide](https://manifest.miglobal.com.mx/docs/guides/EXTERNAL_API_WEBHOOKS.md)

## Auth

```
Authorization: Bearer <key_id>.<secret>
```

## Public endpoints (no auth)

- GET /api/v1/external/health — liveness check
- GET /api/v1/external/version — API and server version
- GET /api/docs — interactive reference
- GET /api/docs/openapi.json — raw OpenAPI 3.1 spec
- GET /.well-known/openapi.json — same spec, standard URI