Skip navigation
VI
REST › content.list

content.list

GET/content

Lists the metadata of subscriber pieces, articles and guides alike. Needs a key from a registered account; subscriber access is not required.

Parameters

ParameterInDescription
localequeryOptional. vi or en.
qqueryOptional. Searches titles, summaries, slugs, tags and section titles. Ignores case and diacritics.
topicqueryOptional. Area: workflow, harness, agents, tools, repos, patterns or system-design.
blogCategoryqueryOptional. Library category: article, deep-dive, tutorial or series.
kindqueryOptional. article or guide (step-by-step). The kind does not decide access: either can be public or for subscribers.
seriesqueryOptional. Series slug, for example inside-omp. Results come in series order.
akKitqueryOptional. AgentKit kit the guide's skill ships in: core (in every kit), engineer or marketing. Only AgentKit skill guides carry it.
limitqueryOptional. Pieces per page, 1 to 100. Leave it out to get the whole listing.
offsetqueryOptional. How many pieces to skip, default 0. For the next page pass the response's nextOffset; the last page has none.

Request

curl
curl "https://api.modernengineer.dev/content?locale=vi" \
  -H "Authorization: Bearer $SE_KEY"

Response

200 OK · application/json
{
  "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": 1
}

Errors

StatusErrorWhen
403forbiddenNo key, or the key does not belong to a registered account.
400invalid_inputA parameter is missing or invalid, for example a locale other than vi or en.

In MCP