Getting Started

Welcome to the Evolvable AI API Integration documentation. This guide covers how to integrate with the Evolvable AI platform from your own applications.

Overview

The Evolvable AI API allows you to:

Embed agents into your own web or mobile applications via the public chat endpoint
Manage agents and agencies programmatically
Upload documents to the knowledge base
Trigger workflows from external systems
Receive events from agent conversations

Authentication

All API requests require a valid authentication token. Obtain a token by posting your credentials to the authentication endpoint:


POST /api/auth/login
Content-Type: application/json
 
{
  "email": "your@email.com",
  "password": "yourpassword"
}

The response includes a JWT token. Pass it in the Authorization header for all subsequent requests:


Authorization: Bearer <token>

Base URL

All API endpoints are relative to your Evolvable AI instance base URL:


https://your-instance.datawise.ai/api

Public Chat

To embed an agent in your own application, use the public chat endpoint. The agent must be configured and assigned to an agency. Point your chat UI to:


POST /api/public/chat

with the agent ID and conversation message. Refer to your Evolvable AI instance API reference for full request/response schemas.

Next Steps

Review your Evolvable AI instance API reference for all available endpoints.
Contact your Datawise administrator for API credentials and instance URL.