Getting Started

Quick start

Create a minimal domain context and confirm read/write path against the Catoids API.

July 3, 2026

Getting Started
1 min read

Goal

Create a minimal domain context, register a workflow definition, and confirm that a decision request round-trips against the Catoids API.

1. Authenticate

import { createClient } from '@catoids/sdk'

const client = createClient({
  baseUrl: process.env.CATOIDS_API_BASE!,
  token: process.env.CATOIDS_TOKEN!,
})

const session = await client.whoami()
console.log(session.tenantId)

2. Register a domain context

Create or select a domain context that will own kernel and workflow configuration. Use the domain id returned by the API for later calls.

3. Submit a decision request

Send a small decision payload against a published workflow or policy definition. Inspect both the decision result and any explanation artefacts returned by the platform.

4. Clean up

Archive or delete evaluation artefacts you no longer need so the tenant stays readable for other developers.