LiveAresGen is live — 65+ models, brand voice, and multilingual content in one workspaceStart free
Sign up

API Reference

REST API.

Bearer-token authenticated. JSON only. Versioned (v1). Idempotency-key support on all mutating endpoints. EU and US regions.

OpenAPI 3.1 specSDKs on GitHub
70+ endpointsv1 — stableEU & US regions

Authentication

Bearer tokens. Per-workspace. Auditable.

Generate API keys in workspace settings. Keys are scoped to a workspace and a role. Rotate keys with a 24-hour grace period. Every request is logged with key id, IP, and user agent.

curl https://api.aresgen.com/v1/chat/completions \
  -H "Authorization: Bearer $ARESGEN_API_KEY" \
  -H "Idempotency-Key: idem_$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @payload.json

Conventions

Predictable. Boring. On purpose.

JSON only

Requests and responses are application/json. UTF-8. No envelopes.

Idempotency

Send Idempotency-Key on POST/PUT/PATCH. Replays return the original response.

Pagination

Cursor-based. limit + cursor. Max page size 100.

Rate limits

600 req/min default. Per-key. 429 with Retry-After. Burst window of 60s.

Errors

RFC 7807 problem details. Stable code fields for branching.

Timestamps

ISO 8601, UTC. Inputs accept any RFC 3339 string.

Chat

3 endpoints
  • POST
    /v1/chat/completions

    Send a chat completion

    Streaming or non-streaming. Any of 65+ models. Optional brand voice.

  • GET
    /v1/chat/threads/{id}

    Fetch a thread

    Retrieve the full message history of a saved thread.

  • DELETE
    /v1/chat/threads/{id}

    Delete a thread

    Permanent. Audit-logged. Triggers data-deletion webhooks.

Documents

3 endpoints
  • POST
    /v1/documents

    Create a document

    Returns a document id and a real-time edit token.

  • POST
    /v1/documents/{id}/commands

    Run an AI command

    Outline, expand, summarize, rewrite, cite, translate.

  • GET
    /v1/documents/{id}/versions

    List versions

    Returns the full version history, ordered by timestamp.

Voices

3 endpoints
  • POST
    /v1/voices

    Create a voice

    Train from a 300-word sample. Returns voice id when ready.

  • GET
    /v1/voices

    List voices

    Returns voices in the active workspace.

  • PATCH
    /v1/voices/{id}

    Update a voice

    Adjust sliders, banned phrases, or sample text.

Chatbots

3 endpoints
  • POST
    /v1/chatbots

    Create a chatbot

    Attach a knowledge base, choose a voice, generate an embed key.

  • POST
    /v1/chatbots/{id}/messages

    Send a message

    Server-side message API for headless integrations.

  • GET
    /v1/chatbots/{id}/conversations

    List conversations

    Filter by time, intent, escalation status, or CSAT.

Workflows

3 endpoints
  • POST
    /v1/workflows

    Create a workflow

    Send a YAML or JSON workflow definition.

  • POST
    /v1/workflows/{id}/runs

    Run a workflow

    Trigger a run with input payload; returns run id.

  • GET
    /v1/workflows/{id}/runs/{run_id}

    Get run status

    Per-step costs, latency, retries, and output.

Get started today.

Free for 7 days. No credit card. Bring your team — or just your first prompt.

Start freeTalk to salesGet an enterprise trial →