{"route":"/developers","title":"Studio Seventeen developer documentation","description":"Public API version 1, Markdown exports, response schemas, error handling, and consent requirements.","enabled":true,"tab":"developers.md","updatedAt":"2026-09-06","url":"https://studioseventeen.io/developers","markdown":"# Studio Seventeen developer documentation\n\nRead public content with GET /api/v1/pages. Add ?path=/omarchy to get one page with Markdown. No API key is needed. OpenAPI: /openapi.json. The /api routes remain compatible aliases. Breaking changes will use a new version path, with at least 90 days notice and Sunset headers before removal.\n\nUse curl https://studioseventeen.io/api/v1/pages for the index. Read requests have no application quota. Newsletter POST /api/v1/subscribe accepts JSON email and sends confirmation only. Ask the user first. Requests allow 10 per IP and 3 per address per hour, plus a five-minute resend cooldown. HTTP 429 includes Retry-After. Only subscribed:true confirms enrollment. Never bypass recipient confirmation. POST /api/v1/subscribe/confirm accepts the opaque token from the requested email.\n\nErrors have an error string; newsletter errors also return success:false and subscribed:false. Keep email addresses and tokens out of URLs and logs. There are no payments, device-control endpoints, API keys, or separate CLI packages. Standard curl and HTTP clients work. Test locally using the website repository and isolated provider settings; production is not a sandbox.\n"}