API Reference

Complete API documentation for all Motte framework endpoints and services.

Authentication

All API requests require authentication using API keys. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.motte.ai
Training API

MotteRL training and model management

POST/api/training/start
View Details →

Start a new training job

GET/api/training/status/{id}
View Details →

Get training job status

GET/api/training/logs/{id}
View Details →

Retrieve training logs

DELETE/api/training/cancel/{id}
View Details →

Cancel training job

Workflow API

MotteAF workflow management

POST/api/workflows/create
View Details →

Create new workflow

POST/api/workflows/execute
View Details →

Execute workflow

GET/api/workflows/{id}
View Details →

Get workflow details

PUT/api/workflows/{id}
View Details →

Update workflow

DELETE/api/workflows/{id}
View Details →

Delete workflow

Memory API

MotteMB memory management

POST/api/memory/store
View Details →

Store new memory

POST/api/memory/search
View Details →

Search memories

POST/api/memory/import
View Details →

Bulk import memories

GET/api/memory/export
View Details →

Export memories

POST/api/memory/optimize
View Details →

Optimize memory bank

GET/api/memory/stats
View Details →

Get memory statistics

DELETE/api/memory/delete/{id}
View Details →

Delete memory

Tools API

MotteTF tool integration

POST/api/tools/generate-schema
View Details →

Generate tool schema

POST/api/tools/test-connection
View Details →

Test tool connection

POST/api/tools/execute
View Details →

Execute tool function

GET/api/tools/{id}
View Details →

Get tool details

Monitoring API

MotteAW monitoring and analytics

GET/api/monitoring/metrics
View Details →

Get system metrics

POST/api/monitoring/alerts
View Details →

Create alert

GET/api/monitoring/alerts
View Details →

List alerts

WebSocket/api/monitoring/stream
View Details →

Real-time metrics stream

Rate Limiting

API requests are rate limited to ensure fair usage:

  • Standard endpoints: 1000 requests per hour
  • Training endpoints: 10 requests per hour
  • Memory operations: 5000 requests per hour
  • Monitoring streams: 5 concurrent connections

Error Handling

The API uses conventional HTTP response codes to indicate success or failure:

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request parameters are invalid",
    "details": {
      "field": "learning_rate",
      "issue": "must be between 0.001 and 0.1"
    }
  }
}

SDKs and Libraries

Python SDK

pip install motte-sdk

Official Python SDK with full API coverage

JavaScript SDK

npm install @motte/sdk

TypeScript-first SDK for Node.js and browsers