Netia

API Documentation

Build powerful integrations with Netia's REST API. Access AI conversations, manage business profiles, and automate workflows.

Getting Started

# Base URL
https://api.netia.ai/v1

# Authentication
curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.netia.ai/v1/conversations

All API requests must include your API key in the Authorization header. You can find your API key in your dashboard settings.

Authentication

API Key

Include your API key in the Authorization header of all requests:

Authorization: Bearer sk-1234567890abcdef

Conversations

Create Conversation

POST /conversations
{
  "business_id": "biz_123",
  "customer_message": "What are your hours?",
  "context": {
    "customer_name": "John Doe",
    "source": "website"
  }
}

Creates a new conversation and returns the AI response.

Get Conversation

GET /conversations/{conversation_id}

# Response
{
  "id": "conv_123",
  "business_id": "biz_123",
  "messages": [
    {
      "role": "customer",
      "content": "What are your hours?",
      "timestamp": "2024-01-01T12:00:00Z"
    },
    {
      "role": "assistant", 
      "content": "We're open Monday-Friday 9AM-5PM",
      "timestamp": "2024-01-01T12:00:01Z"
    }
  ]
}

Business Profiles

Update Business Profile

PUT /business-profiles/{business_id}
{
  "name": "Acme Dental",
  "hours": "Monday-Friday 9AM-5PM",
  "services": ["General Dentistry", "Cleanings"],
  "pricing": {
    "cleaning": "$150",
    "checkup": "$100"
  },
  "contact": {
    "phone": "+1-555-0123",
    "email": "info@acmedental.com"
  }
}

Updates your business profile to improve AI response accuracy.

Webhooks

Configure Webhook

POST /webhooks
{
  "url": "https://your-app.com/webhook",
  "events": ["conversation.created", "conversation.updated"],
  "secret": "your-webhook-secret"
}

Set up webhooks to receive real-time notifications about conversations.

Rate Limits

100
Requests per minute
10,000
Requests per day
1,000
Conversations per hour

SDKs & Libraries

JavaScript/Node.js

npm install @netia/sdk

import { NetiaClient } from '@netia/sdk';

const client = new NetiaClient('your-api-key');
const response = await client.conversations.create({
  business_id: 'biz_123',
  customer_message: 'What are your hours?'
});

Python

pip install netia-sdk

from netia import NetiaClient

client = NetiaClient('your-api-key')
response = client.conversations.create(
    business_id='biz_123',
    customer_message='What are your hours?'
)

Ready to start building?

Get your API key and start integrating Netia into your applications.

Get API KeySee it in action