/v1 surface.
Start in 5 minutes
Create an API key, call your account endpoint, and make the first
authenticated request.
Authentication
Send the
x-api-key header and keep keys in server-side environments only.Rate limits
Understand quotas, per-minute limits, and response headers.
OpenAPI source
Inspect the live OpenAPI 3.1 document that powers the API reference.
Base URL
The production API base URL is:/v1.
Authentication model
Public API requests are authenticated with named API keys. Each request acts as the user who owns the key, so product resources are automatically scoped to that owner.Common integration paths
Collect anecdotes
Create text, audio, or spreadsheet-based anecdotes that become source
material for content.
Manage posts
Create drafts, schedule posts, publish, mark external publication, and
manage media.
Run generation jobs
Generate post drafts from anecdotes and track generation job state.
Read analytics
Pull dashboard summaries, recent posts, and pending validation items.
What is generated automatically?
The API reference is generated fromhttps://api.yalg.ai/openapi.v1-3.1.json, the public OpenAPI 3.1 document served by the YALG backend. The backend validates at startup that documented request bodies and non-empty responses include schemas, so the reference stays aligned with the API surface.