Anecdotes - YALG Developer Docs

Anecdotes are source stories YALG can transform into posts, scripts, carousels, and other creative assets.

Create a text anecdote

Use a text anecdote when your integration already has structured story content.

curl https://api.yalg.ai/v1/anecdotes \
  -H "x-api-key: $YALG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How I learned to delegate",
    "content": "Last year I realized I was blocking my team by holding too much context.",
    "storyType": "professional_stories",
    "tags": ["leadership", "teamwork"]
  }'

Upload an audio anecdote

Use audio when your product records voice notes or interviews.

curl https://api.yalg.ai/v1/anecdotes/audio \
  -H "x-api-key: $YALG_API_KEY" \
  -F "audio=@story.m4a" \
  -F "title=Delegation lesson" \
  -F "tags=leadership,teamwork"

Batch import anecdotes

Batch import accepts spreadsheet files for migrating existing story libraries.

curl https://api.yalg.ai/v1/anecdotes/batch \
  -H "x-api-key: $YALG_API_KEY" \
  -F "file=@anecdotes.xlsx"

Export anecdotes

Use exports to sync YALG back into your own system:

GET /v1/anecdotes/export/csv
GET /v1/anecdotes/export/voice

Generate from an anecdote

After an anecdote exists, create a content workflow from it:

POST /v1/anecdotes/{id}/post
POST /v1/post-generation/from-anecdote

Requests are scoped to the API key owner. You do not need to send authorId.

​Create a text anecdote

​Upload an audio anecdote

​Batch import anecdotes

​Export anecdotes

​Generate from an anecdote

Create a text anecdote

Upload an audio anecdote

Batch import anecdotes

Export anecdotes

Generate from an anecdote