Python SDK

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.get_all({"page": 1, "limit": 10, "categoryId": "..."})

if res.ok:
    print(res.data)   # the envelope's `data`
    print(res.meta)   # pagination metadata
else:
    print(res.error.status, res.error.message)

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

created = cms.article.create({
    "title": "Hello world",
    "body": "...",
    "categoryId": "6810f2c3a1b2c3d4e5f60712",
    "authorId": "6810f2c3a1b2c3d4e5f60719",
})

updated = cms.article.update(created.data["id"], {"title": "Updated"})
cms.article.delete(created.data["id"])

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

if not res.ok:
    print(res.error.status)    # 404
    print(res.error.message)   # human readable
    print(res.error.payload)   # full API body

from octavia_cms_sdk import ApiError

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

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

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

res = cms.raw.request("GET", "/articles/advancedSearch", query={"body": {"minWords": 500}})