Aether AI
API ReferenceGuidesSDKsFAQ

API reference

The Aether REST API.

A predictable, resource-oriented API over HTTPS with JSON payloads, bearer authentication and standard status codes.

Authentication

Authenticate with a secret key in the Authorization header. Keys live in your dashboard under Settings → API.

base url + auth
# Base URL
https://api.aetherai.support

# Every request
Authorization: Bearer $AETHER_KEY

Conversations

POST/v1/messages

Send a message

Send a customer message to the AI agent and receive a grounded reply with source citations and a confidence score.

Parameters

textstringrequiredThe customer's message.
conversation_idstringContinue an existing conversation.
userobjectIdentity ({ id, email, name }) for personalization.
example request
curl https://api.aetherai.support/v1/messages \
  -H "Authorization: Bearer $AETHER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"How do I reset my password?"}'
GET/v1/conversations/{id}

Retrieve a conversation

Fetch the full message history, citations and resolution status for a conversation.

example request
curl https://api.aetherai.support/v1/conversations/conv_4821 \
  -H "Authorization: Bearer $AETHER_KEY"

Tickets

GET/v1/tickets

List tickets

List tickets with optional status, priority and assignment filters.

Parameters

statusstringopen · in_progress · resolved · closed
limitintegerPage size (default 25, max 100).
example request
curl "https://api.aetherai.support/v1/tickets?status=open" \
  -H "Authorization: Bearer $AETHER_KEY"
POST/v1/tickets

Create a ticket

Open a ticket. The agent auto-classifies priority, category and SLA.

Parameters

subjectstringrequiredShort summary of the issue.
descriptionstringrequiredFull detail of the request.
categorystringgeneral · technical · billing · feature_request
example request
curl https://api.aetherai.support/v1/tickets \
  -H "Authorization: Bearer $AETHER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Double charge","description":"Charged twice on May 3."}'
POST/v1/tickets/{id}/messages

Reply to a ticket

Append a message to a ticket thread, with optional attachments.

example request
curl https://api.aetherai.support/v1/tickets/tkt_4821/messages \
  -H "Authorization: Bearer $AETHER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"A refund is on the way."}'

Knowledge base

POST/v1/knowledge/documents

Add a document

Index a document into the knowledge base. Embeddings are generated automatically.

Parameters

titlestringrequiredDocument title.
contentstringrequiredRaw text or markdown.
example request
curl https://api.aetherai.support/v1/knowledge/documents \
  -H "Authorization: Bearer $AETHER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Refund policy","content":"Refunds within 30 days..."}'
POST/v1/knowledge/crawl

Crawl a site

Crawl and index a URL on a schedule so answers stay current.

example request
curl https://api.aetherai.support/v1/knowledge/crawl \
  -H "Authorization: Bearer $AETHER_KEY" \
  -d '{"url":"https://docs.yoursite.com"}'

Looking for SDKs? JavaScript, React & Python →