catalog.list
GET/catalog
Lists the metadata of every published piece (public and subscriber alike) in one language. No key needed.
Parameters
| Parameter | In | Description |
|---|---|---|
locale | query | Required. vi or en. |
q | query | Optional. Searches titles, summaries, slugs, tags and section titles. Ignores case and diacritics. |
topic | query | Optional. Area: workflow, harness, agents, tools, repos, patterns or system-design. |
blogCategory | query | Optional. Library category: article, deep-dive, tutorial or series. |
kind | query | Optional. article or guide (step-by-step). The kind does not decide access: either can be public or for subscribers. |
series | query | Optional. Series slug, for example inside-omp. Results come in series order. |
akKit | query | Optional. AgentKit kit the guide's skill ships in: core (in every kit), engineer or marketing. Only AgentKit skill guides carry it. |
limit | query | Optional. Pieces per page, 1 to 100. Leave it out to get the whole listing. |
offset | query | Optional. How many pieces to skip, default 0. For the next page pass the response's nextOffset; the last page has none. |
Request
curl "https://api.modernengineer.dev/catalog?locale=vi&limit=20"Response
{
"items": [
{
"access": "subscriber",
"alternate": "/en/library/omp-model-routing-guide",
"blogCategory": "series",
"canonical": "/vi/library/omp-model-routing-guide",
"category": "facebook_subscriber",
"created": "2026-08-26",
"kind": "guide",
"license": "Subscriber-only; redistribution prohibited",
"locale": "vi",
"readingMinutes": 19,
"rightsOwner": "Thieu Nguyen",
"route": "/vi/library/omp-model-routing-guide",
"sections": [
"1. Chuỗi định tuyến",
"2. Nhà cung cấp xuất hiện trong bài",
"3. Role hoạt động và được trigger ra sao?",
"…"
],
"sha256": "29537d02…",
"slug": "omp-model-routing-guide",
"summary": "Role OMP là alias định tuyến, không phải agent. Gán model theo workload, kiểm tra effective state, và fallback khi lỗi.",
"tags": [
"oh-my-pi",
"models",
"routing",
"advisor"
],
"title": "Định tuyến model trong OMP: role, fallback và cấu hình thực tế",
"topic": "harness",
"updated": "2026-08-30",
"version": "1.0.0",
"visual": {
"contentType": "text/html; charset=utf-8",
"key": "visuals/omp-model-routing-guide/d6c28f8f….html"
}
}
],
"total": 164,
"nextOffset": 20
}Errors
| Status | Error | When |
|---|---|---|
| 400 | invalid_input | A parameter is missing or invalid, for example a locale other than vi or en. |