Reference table
| Agent need | API feature | Why it matters |
|---|---|---|
| Discovery | llms.txt + OpenAPI | The agent can understand available fields |
| Safe retries | Idempotency-Key | No duplicate render billing on network retry |
| Revision loop | lint[] | Failures become actionable next steps |
| Human gates | billing_url and upload separation | Payment and publishing stay explicit |
The ideal agent loop
Draft the request, render with a test key, read lint, revise the JSON, and present final assets plus any human approval links.