API Documentation

Introduction

The EvolC API is a RESTful API that uses JSON for request and response bodies. All API requests should be made to the base URL with the appropriate endpoint path.

This API is designed for developers building on top of EvolC or integrating EvolC's autonomous agent capabilities into their own applications.

Base URL

Authentication

Currently, the EvolC API is in development mode and does not require authentication. In production, all requests will require an API key passed in the Authorization header:

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

Error responses include a JSON body with details:

{
  "error": "Organization not found"
}

Organizations

Organizations are the top-level entity in EvolC. Each organization contains universes, worlds, and agents.

Create an Organization

// Request
{
  "slug": "acme-corp",
  "name": "Acme Corporation"
}

// Response (201 Created)
{
  "slug": "acme-corp",
  "name": "Acme Corporation",
  "created": "2025-10-09T00:00:00Z",
  "plan": "starter",
  "gridSize": 5,
  "maxAgents": 25,
  "storageBackend": "local"
}

List Organizations

Get Organization