API Reference

Build powerful integrations with the emma API.

Base URL

https://api.emma.ai/v1

Authentication

All API requests require authentication using an API key.

curl -X GET "https://api.emma.ai/v1/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get your API key from the emma Dashboard.

Quick Start

Get your API key

Navigate to Settings > API in the emma dashboard.

Make your first request

Test the connection with a simple status check.

Explore endpoints

Browse the available endpoints below.

Available Endpoints

Sessions

Create and manage conversation sessions.

Messages

Send messages and receive responses.

Knowledge

Manage your knowledge base.

Webhooks

Set up event notifications.

Rate Limits

Plan	Requests per minute
Free	10
Pro	100
Enterprise	Custom

Response Format

All responses are returned in JSON format:

{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Error Handling

Errors follow a consistent format:

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "Description of the error"
  }
}

Status Code	Description
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
429	Rate Limited
500	Internal Server Error

SDKs

Python

pip install emma-sdk

Node.js

npm install @emma/sdk

Go

go get emma.ai/sdk

Authentication

​API Reference

​Base URL

​Authentication

​Quick Start

​Available Endpoints

Sessions

Messages

Knowledge

Webhooks

​Rate Limits

​Response Format

​Error Handling

​SDKs

Python

Node.js

Go

API Reference

Base URL

Authentication

Quick Start

Available Endpoints

Rate Limits

Response Format

Error Handling

SDKs