# postcache

> Public, short-lived media URLs for AI agents that post to Instagram, Threads and Facebook. Upload a file, pay per request (x402 or Stripe MPP) or with an API key, get an HTTPS URL that passes the platform's media checks, delete it after the post.

Status: early access. The REST API below is live for early-access keys; MCP and pay-per-request are planned.

## API

Base URL: https://postcache.dev. Auth: `Authorization: Bearer pc_live_...` (early access keys from hello@postcache.dev).

- `PUT /v1/media` with the file as the raw body. Headers: `x-target` (one of instagram.feed, instagram.carousel, instagram.reels, instagram.story, threads, facebook.page), optional `x-filename`. Query: `ttl` seconds, 3600-604800, default 86400.
  - 201: `{ id, url, target, content_type, size, expires_at, checks }`. Give `url` to the platform API (image_url / video_url).
  - 422: `{ error: "checks_failed", checks: { problems: [{ rule, message, fix }] } }`. Apply the `fix` and upload again.
  - 401 bad key, 400 bad target/ttl, 413 over 1 GiB.
- `GET /v1/media/{id}`: status, expiry, fetch count, checks.
- `DELETE /v1/media/{id}`: delete now (204). Call it after the post is published.
- Media URLs: `https://cdn.postcache.dev/m/{id}/{name}`; 410 after expiry or delete.

## MCP (planned)

`https://postcache.dev/mcp`, tools `upload_media`, `check_media`, `delete_media`.

## Contact

hello@postcache.dev