Introduction

The LegionEdge Platform is the foundational layer that powers all LegionEdge products. It provides identity management, project orchestration, resource allocation, and API access for developers building on the LegionEdge ecosystem.

Who Is It For?

• Application developers building products that leverage AI agents (Nokuva), contextual data (Tovac), or managed infrastructure (Foltrac).
• Platform engineers who need a unified control plane for managing organizations, teams, and deployments.
• DevOps teams looking for CI/CD integration, webhook-driven automation, and environment promotion workflows.

Key Concepts

Organizations

An organization is the top-level entity in the platform. Every resource -- projects, teams, API keys -- belongs to an organization. Organizations map to your company or team and provide the boundary for billing and access control.

Projects

Projects are the primary unit of work. Each project contains resources, environment configurations, and team membership. Projects support multiple environments (development, staging, production) with independent settings.

Resources

Resources represent any entity managed by the platform: compute instances, data stores, AI agent deployments, or custom integrations. Resources are scoped to a project and tracked through their full lifecycle.

API Keys and Tokens

The platform supports two authentication mechanisms: long-lived API keys for server-to-server communication and short-lived JWT tokens obtained through the OAuth 2.0 flow for user-facing applications.

Platform Architecture

The LegionEdge Platform follows a microservices architecture with an API gateway at the edge. All requests flow through the gateway, which handles authentication, rate limiting, and routing.

Client -> API Gateway -> Auth Service
                      -> Project Service
                      -> Resource Service
                      -> Integration Service (Nokuva, Tovac, Foltrac)

Each service is independently deployable and communicates via an internal event bus for asynchronous operations and direct gRPC calls for synchronous requests.

SDK Overview

The official SDK, @legionedge/sdk, provides a typed client for all platform APIs:

import { LegionEdge } from "@legionedge/sdk";

const client = new LegionEdge({
  apiKey: process.env.LEGIONEDGE_API_KEY,
});

// The client exposes namespaced methods for each service
const orgs = await client.organizations.list();
const projects = await client.projects.list({ organizationId: orgs[0].id });

Next Steps

• Install the SDK to start building.
• Follow the quickstart guide for a hands-on tutorial.
• Read about the platform architecture for a deeper understanding.