Skip to main content
GET
/
v1
/
anecdotes
/
random
Get random anecdote
curl --request GET \
  --url https://api.yalg.ai/v1/anecdotes/random \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "018f9f41-22a1-74bb-9450-7dd0d21ab8ab",
    "title": "The onboarding lesson",
    "content": "A customer got stuck on step one, which showed us the product was explaining itself too late.",
    "mood": "reflective",
    "storyType": "lesson",
    "tags": [
      "onboarding",
      "product"
    ],
    "isFavorite": false,
    "createdAt": "2026-06-20T17:24:39.000Z",
    "updatedAt": "2026-06-20T17:24:39.000Z"
  }
]

Authorizations

​
x-api-key
string
header
default:yalg_live_your_api_key
required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Query Parameters

​
storyType
enum<string>

Story type to filter by

Available options:
professional_stories,
personal_stories,
lesson_learned
Example:

"lesson"

Response

Random anecdote retrieved successfully

Source anecdote used by YALG content workflows.

​
id
string<uuid>

Anecdote identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

​
title
string
Example:

"The onboarding lesson"

​
content
string
Example:

"A short story that can be turned into content."

​
mood
string
Example:

"reflective"

​
storyType
string
Example:

"lesson"

​
tags
string[]
​
isFavorite
boolean
Example:

false

​
createdAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"

​
updatedAt
string<date-time>
Example:

"2026-06-20T17:24:39.000Z"