Query content and iterate documents

List published content

1const { data, meta } = await cms.content.list({
2  limit: 20,
3  offset: 0,
4  status: "published",
5  sort: "updated_at",
6  dir: "desc",
7});

cms is a client created with createClient. Content lists return data plus meta. Field projection, include options, and where filters use the server’s collection contract.

Create and update a record

1const { data: article } = await cms.content.create({
2  collectionId: "articles",
3  title: "Hello",
4  status: "draft",
5  data: { body: "First draft" },
6});
7await cms.content.update(article.id, { title: "Updated draft" });

Use a collection id that exists in your CMS. Fields must satisfy its schema. Test writes on disposable records and retain ids for later updates.

Iterate the documents API

1for await (const document of cms.documents.iterate({
2  type: "articles",
3  locale: "en",
4  limit: 20,
5})) {
6  console.log(document.id);
7}

Documents use keyset pagination with {updatedAt, id} cursors, rather than the content API’s offsets. Do not mix the pagination contracts. The iterator advances document pages until the server reports no next cursor.