# FooPixel

> Agent-native image hosting with account-managed delivery settings.

FooPixel accepts image bytes and returns a public URL for the original image.

## Current status

- Foundation release. Availability depends on the deployment and launch gates.
- Do not describe unverified deployments or planned features as live.
- Machine-readable contract: https://foopixel.com/openapi/openapi.yaml
- Human-readable docs: https://foopixel.com/docs.md
- Pricing is indicative only: https://foopixel.com/pricing.md

## Product rules

- Anonymous uploads receive a public, expiring image URL.
- Uploaded content may be processed and moderated before it becomes available.
- Some ownership and delivery settings are available only through the signed-in account interface.
- Agents should use only the documented upload capabilities.

## v1 route names

`POST /v1/uploads`, `POST /v1/uploads/{id}/complete`, `GET /v1/assets/{id}`, `GET /v1/assets`, `GET|HEAD /a/{publicId}`.

Create upload accepts JPEG, PNG, WebP, HEIC, or HEIF and requires the lowercase hexadecimal SHA-256 of the exact bytes. Anonymous sessions are limited to 5 MiB and a 2000px policy width. The response returns `upload`, `policy`, and a one-time `completionToken`; optional client processing is `{ "mode": "client", "maxWidth": 2000, "optimized": true }` only for a WebP the browser already prepared. HEIC and HEIF sources omit `processing`. Complete with JSON `{ "uploadToken": "..." }`. Uploaded images are validated, processed, and may be moderated before delivery.