Overview

Overview

Base URL, structure and scope of the elunos.ai API.

The API lets you run elunos.ai from your own system: create and configure agents, connect tools to your own endpoints, maintain knowledge and review conversations. It works over HTTPS, takes and returns JSON, and is authenticated with a key in the request header.

https://app.elunos.ai/api/v1

Structure

Everything that belongs to a space lives under /spaces/{space}. A space is the workspace of one business with its agents, connections, tools and conversations. {space} is its slug, for example praxis-mueller, and is returned by List spaces.

The knowledge base is the exception: it still lives directly under /knowledge, and the key determines which space is meant.

What the API covers

The typical sequence

  1. Create a connection to your endpoint and store its credentials in the platform.
  2. Create tools that fetch data or trigger something through that connection.
  3. Create an agent, set its behavior and attach the tools.
  4. Publish. Changes apply in conversations only after that.
  5. Fetch conversations and check what the agent did.

What stays in the platform on purpose

Buying and assigning phone numbers, connection credentials, the web widget and billing are set up in the platform. The API never accepts or returns credentials.

Continue with Authentication, then Responses and errors.