Install Python

pip install octavia-cms-sdk

import os
from octavia_cms_sdk import CMS

cms = CMS.init(
    os.environ["OCTAVIA_API_KEY"],
    timeout_ms=30_000,
    throw_on_error=False,
)

res = cms.article.getAll(query={"page": 1, "limit": 10, "category": "..."})

if res.ok:
    print(res.data.article_list_item)   # a typed dataclass, not a dict
    print(res.meta)                     # pagination metadata
else:
    print(res.error["message"])

one     = cms.article.getById("6810f2c3a1b2c3d4e5f60718")
by_slug = cms.article.getBySlug("hello-world")
hits    = cms.article.search(query={"keyword": "typescript", "limit": 5})

print(one.data.article.slug)             # the envelope's `article` key

created = cms.article.create({
    # The title and body are keyed by language code.
    "mainTitle": {"en": "Hello world"},
    "content": {"en": "<p>...</p>"},
    # category is a list of category IDs.
    "category": ["6810f2c3a1b2c3d4e5f60712"],
    "author": "6810f2c3a1b2c3d4e5f60719",
})

print(created.data.article._id)

updated = cms.article.update({
    "id": created.data.article._id,
    "mainTitle": {"en": "Updated"},
})
cms.article.deleteId(created.data.article._id)

res = cms.article.getById("does-not-exist")

if not res.ok:
    print(res.error["message"])   # human readable

from octavia_cms_sdk import ApiError

cms = CMS.init(key, throw_on_error=True)

try:
    cms.article.getById("does-not-exist")
except ApiError as err:
    print(err.status, err.payload)

cms = CMS.init(key, timeout_ms=5_000)

from octavia_cms_sdk.models import ArticleList

res = cms.raw.request("GET", "/articles/advanceSearch", query={"keyword": "typescript", "limit": 5})

typed = cms.raw.request_typed(ArticleList, "GET", "/articles/advanceSearch", query={"keyword": "typescript", "limit": 5})
print(typed["data"].article_list_item)