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

# Public Ad Copy API

> Preview REST contract for workspace-grounded Facebook and Instagram ad copy

This is the Next.js `/api/v1` contract for one Meta ad-copy job. It is a design-partner preview. FastAPI stays private. Personal API tokens (`oly_`) are the only credential. MCP OAuth tokens (`ola_` / `olr_`) are rejected.

The four operations are:

* `POST /api/v1/ad-copy-generations`
* `GET /api/v1/ad-copy-generations/{id}`
* `GET /api/v1/ad-copy-generations`
* `GET /api/v1/offers`

Submit a brief. Poll the job until `succeeded` or `failed`. There are no webhooks in v1.

These pages stay out of the public docs navigation until the preview enablement checklist in `docs/modules/public-api-preview.md` is complete.

See [authentication](/api-reference/authentication) and [ad copy generations](/api-reference/ad-copy-generations).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.