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

# Changelog

Release notes for the Motioness platform.

# Changelog

## v1.1 — Motion Proxy Pivot (May 2026)

The big one. Motioness pivots from a templates product to a drop-in image-to-motion proxy.

### Added

- **Public proxy URL** — `GET /v1/{projectKey}/{src}.{format}` returns a looping mp4 (`.mp4`) or poster (`.jpg`).
- **Three motion modes** — `loop`, `animate-in`, `animate-on-hover`.
- **Brand context injection** — Firecrawl deep-crawl extracts colors, fonts, content inventory, and tone; injected into the vision prompt.
- **Signed URL mode** — HMAC-SHA256 with `?sig=…&exp=…` for cross-origin / short-lived URLs.
- **Standard Webhooks** — `asset.completed`, `asset.failed`, etc. with HMAC signatures, idempotency keys, retry schedule, dead-letter queue.
- **SSE event streams** — public per-asset (`/v1/{key}/events/{id}`) and auth-gated per-project (`/api/projects/{id}/activity`).
- **Long-poll `?wait_ms=`** — block up to 10s waiting for the mp4 to finalize.
- **Edge cache + KV index** — hot mp4s serve in ~5ms.
- **Query parameters** — `idem`, `pipeline`, `aspect`, `seed`, `prompt`, `motion`, `dur`, `mode`.
- **Per-stage retry envelope** — transient failures retry up to 3 attempts per stage with backoff.
- **Cron reconciler** — finalizes assets stuck pending past 5 minutes via direct Replicate state queries.

### Changed

- `quality` parameter renamed to `mode` and given three new values (`loop`, `animate-in`, `animate-on-hover`).
- Templates product moved to `legacy/`; existing template URLs continue to work indefinitely.

### API surface

All new endpoints are documented in this site's [API Reference](/api/overview), with an OpenAPI 3.1 spec at [`https://motioness.com/api/openapi.json`](https://motioness.com/api/openapi.json).

### Migration notes

Existing customers on the templates product don't need to do anything — template URLs keep working. New embeds should use the proxy URL pattern.

## v1.0 — Templates (legacy)

The original Motioness — pick a template, customize, embed. Now archived under `legacy/`. Template URLs are still served indefinitely for existing customers.

## Known limitations (deferred)

- `Server-Timing` header on cache-miss responses — not yet wired (deferred to v1.2).
- AE-driven ETA p50 — currently uses a static fallback table by `(pipeline, model)`.
- Server-side aspect pre-crop for `wan-fast` and `p-video` — only `seedance` natively supports it today.
- True re-execution of arbitrary stages from the retry queue — recovery comes from the call-site retry envelope and the cron reconciler.
- BYO Replicate API key + custom model slug — on the v1.3 roadmap.
- Public delete-by-URL for uploaded sources — on the v1.2 roadmap.

For incident updates, follow [@motioness](https://x.com/motioness) on X.