AI-Native Operating System

Documentation

The Ergondata platform is an operating system born to run with AI. Humans and self-governing agents work on the same modeled business under one identity, one permission model, and one audit trail — bounded when you want them bounded, autonomous when you want them autonomous.

Start with the Concepts to understand how this works. Use the Guides to learn how to build with each service. Dive into the API Reference when you need field-level detail.

Concepts

The six pieces of the worldview. Read these once and the rest of the documentation tells a coherent story.

Guides

Understand how each service works, how they connect, and how to integrate them.

Platform Overview

Understand the platform architecture, its twelve services, the tenancy model, and how everything connects.

IAM

Identity and access for the whole platform — principals, companies, members, API keys, agent identities, and permission checks.

Agent Hub

How LLM agents work — configs, modes, conversations, invocation, and integration patterns.

Conversations

The dialogue substrate — conversation lifecycle, paginated messages, notes & summaries, privacy, and real-time streaming.

Apps

Governed React apps on the platform's own tools — source files, immutable versions, tool policies, and caller-authorized runtime calls.

Automations

React to events with step graphs — triggers, runs, resume keys, and cross-service connections.

Events & Trigger Catalog

Browse every automation event, payload schema, resource scope, and compatible predicate operator.

Workflows

Phases, routing, items, automations, templates, and public forms.

How Items Move

Cooldowns, claims and retries, timeouts and timeout rules, Exceptions and automatic redrive.

Channels

Multi-channel messaging, email setup, inbound triggers, and agent routing.

Buckets

Document ingestion pipeline, AI processing, semantic search, and cross-service sharing.

Worksheets

Spreadsheet-style data with typed columns, views, formulas, and automations.

Event Streams

Centralized event store — query event history, metrics, distributed traces, and stream updates in real-time.

Compute

APIs for prepared HTTP calls, governed egress, and Vault-backed credential indirection. Functions and Browser are coming soon.

Vault

Namespaces and credentials for secrets. Server-side resolution and crypto, with secrets that never leave the boundary.

Permissions

RBAC model, principals, roles, resource patterns, and cross-service grants.

Webhooks & Events

Real-time events, WebSocket streams, channel triggers, and payload formats.

API Reference

Detailed endpoint documentation with request/response schemas and code examples.

IAM

Central identity and access management — companies, members, roles, permissions, API keys, agents, and service access control for the entire platform.

266 endpoints

Agent Hub

Configure and run AI agents with LLM provider keys, model configs, tool access, and real-time agent invocation with streaming responses.

136 endpoints

Conversations

The universal substrate for dialogue — human↔human, human↔agent, and agent↔agent. Identity, permissions, audit, and real-time streaming built in.

48 endpoints

Apps

Governed React apps built on the platform's own tool catalog — immutable versions, explicit tool policies, and every call authorized with the identity and permissions of the person using the app.

53 endpoints

Automations

The reaction substrate. Subscribe to events, run step graphs that invoke agents, send messages, transition workflow items — autonomy expressed as policy.

60 endpoints

Workflows

Kanban-style workflows with phases, fields, routing, items, assignment groups, templates, automations, and public forms for external submissions.

237 endpoints

Channels

Multi-channel messaging with email configs, addresses, outbound send, inbound triggers, address-level ACL, and cross-service grants.

89 endpoints

Buckets

Document management with folders, file uploads, AI-powered text extraction, chunking, and vector-based semantic search for RAG.

77 endpoints

Worksheets

Spreadsheet-style data with typed columns, rows, saved views, CSV/XLSX import and export, automations, and real-time collaboration.

114 endpoints

Event Streams

Centralized event store that ingests events from all services. Query event history, metrics, distributed traces, and stream updates in real-time.

42 endpoints

Compute

Run prepared API requests and one-off HTTP calls with layered egress control and Vault-backed credential indirection. Functions and Browser families coming soon.

62 endpoints

Vault

Store, encrypt, and resolve secrets through namespaces and credentials. Server-side resolution and cryptographic operations keep secrets out of every response.

35 endpoints

Authentication

All API requests require a Bearer token. Authenticate using API keys with the client credentials flow.

Learn about authentication →

Base URL

All services are accessible through a unified gateway at https://platform.ergondata.ai. Each service has its own path prefix.

View service prefixes →