API Reference
ainative-business exposes a local REST API with 191 endpoints across 25 domains.
All endpoints accept and return JSON. Authentication is handled by provider API keys configured in Settings.
Base URL
http://localhost:3000 ainative-business runs locally. All API calls are made to your local instance.
Core
Tasks
13 endpointsCreate, execute, cancel, and monitor task lifecycle with fire-and-forget execution and SSE log streaming.
Projects
7 endpointsManage project workspaces with working directories, document bindings, and cascading resource cleanup.
Workflows
14 endpointsOrchestrate multi-step execution patterns with debug analysis, resume, and optimization suggestions.
Blueprints
5 endpointsStore and instantiate reusable workflow templates with import and lineage tracking.
Schedules
6 endpointsClock-driven cron and heartbeat schedules with natural language parsing, manual execution, and delivery channels.
Intelligence
Chat
13 endpointsMulti-provider conversations with SSE streaming, skill composition, export, model selection, and entity search.
Profiles
15 endpointsAgent profiles with multi-runtime support, testing, learned context, repository import, and AI-assisted creation.
Runtimes
2 endpointsQuery available agent runtimes and their capabilities across five providers.
Memory
2 endpointsEpisodic agent memory with decay scoring and confidence tracking.
Content
Documents
7 endpointsUpload, preprocess, version, and download files with automatic text extraction.
Tables
29 endpointsStructured data grids with columns, rows, charts, triggers, enrichment, import/export, and templates.
Uploads
4 endpointsFile upload management with storage cleanup and metadata retrieval.
Views
4 endpointsSaved view configurations with filters, sorting, and column visibility.
Platform
Settings
24 endpointsProvider configuration, runtime routing, budgets, permissions, browser tools, chat pins, saved searches, and pricing.
Permissions
5 endpointsPermission patterns and presets for tool access control and agent governance.
Notifications
6 endpointsApproval requests, alerts, and SSE streaming for pending permission decisions.
Channels
6 endpointsMulti-channel delivery via Slack, Telegram, and webhooks with bidirectional messaging.
Environment
10 endpointsScan, audit, and manage CLI environments with health scoring, artifact discovery, and skill listing.
Snapshots
4 endpointsDatabase backup and restore with point-in-time snapshot management.
Workspace
4 endpointsDiscover, import, fix data directories, and analyze project workspace context for agent onboarding.
Instance
5 endpointsInstance configuration, initialization, and guided upgrade detection with version polling.
Operations
Logs
1 endpointsReal-time agent log streaming via Server-Sent Events with keepalive and backoff.
Handoffs
2 endpointsAgent handoff records for transferring execution context between runtimes.
Data
2 endpointsDatabase maintenance — clear all data or seed with sample records.
Context
1 endpointsBatch approve or reject learned context proposals from agent interactions.
Common Patterns
- Validation — Request bodies validated with Zod. Errors return
400witherror.flatten()format. - IDs — All resources use UUID v4 identifiers, auto-generated on creation.
- Fire-and-forget — Execution endpoints return
202 Acceptedwhile work runs asynchronously. - SSE — Streaming endpoints use
text/event-streamwith keepalive heartbeats. - Timestamps — All dates are ISO 8601 strings in responses.