REST API & TypeScript / Python SDK Reference

Key Public & Authenticated Endpoints

• GET /healthz & GET /readyz — Liveness and readiness probes
• GET /v1/public/downloads — Unauthenticated signed release catalog & machine-matched runtime selector
• GET /v1/public/downloads/:artifactId — Direct binary stream with x-checksum-sha256 header
• GET /v1/signup/config, POST /auth/signup/register, POST /auth/signup/verify, POST /v1/signup/tenants — Self-serve multi-tenant organisation sign-up
• POST /v1/sessions, POST /v1/tasks, POST /v1/chat/completions — Governed agent sessions and model broker

TypeScript SDK (@mindaeon/sdk)

import { createMindaeonClient } from "@mindaeon/sdk";

const client = createMindaeonClient({
  baseUrl: "https://mindaeon.ai",
  token: process.env.MINDAEON_TOKEN,
});

const downloads = await client.downloads.list();
console.log("Verified artifacts:", downloads.artifacts.length);

Python SDK (mindaeon-sdk)

from mindaeon_sdk import MindaeonClient

client = MindaeonClient(base_url="https://mindaeon.ai", token=os.environ["MINDAEON_TOKEN"])
session = client.sessions.create(project_id="default", prompt="Audit OpenAPI contracts")