Categories (SDK)

Typed client for content categories.

Wraps the Categories REST API.

Methods

inventra.categories.list()

Returns every category defined for the organization.

const categories = await inventra.categories.list();

Returns Promise<Category[]>

Type

interface Category {
  id: string;
  slug: string;
  value: string; // display name
}

Example: category navigation

import Link from 'next/link';

const categories = await inventra.categories.list();

<nav>
  <ul>
    {categories.map((cat) => (
      <li key={cat.slug}>
        <Link href={`/blog/category/${cat.slug}`}>{cat.value}</Link>
      </li>
    ))}
  </ul>
</nav>

Example: filtering posts by category

const [posts, categories] = await Promise.all([
  inventra.contents.list(),
  inventra.categories.list()
]);

const marketingPosts = posts.filter((p) => p.categorySlug === 'marketing');