Eden API Documentation

API documentation for the Eden product

Table of ContentsCopied!

Platform OverviewCopied!

Eden is a developer-first platform designed to simplify infrastructure and deployment for teams operating in highly regulated environments. At its core, Eden provides a robust framework for connecting disparate systems, transforming data between formats, and automating complex business processes.

The platform consists of two main components:

  1. Eden API - A comprehensive RESTful API service for data integration, transformation, and workflow management

  2. Eden-MDBS - An ACID-compliant cross-border database abstraction service that allows users to interact with multiple independent database systems through a shared API

Eden excels at:

  • Data Integration: Connect and communicate with external systems through endpoints

  • Data Transformation: Convert, map, and process data using templates and JSON utilities

  • Process Automation: Define and execute complex workflows spanning multiple systems

  • Access Control: Manage permissions with fine-grained control through IAM and RBAC

  • Multi-Database Management: Interact with multiple independent database systems through a unified interface

API DocumentationCopied!

Authentication

Eden uses JWT (JSON Web Token) based authentication to secure API access. Authentication is managed through the following endpoints:

  • /auth/login - Obtain a JWT token by providing valid credentials

  • /auth/refresh - Refresh an existing JWT token

  • /auth/password/reset - Request a password reset

Login Process

To obtain a JWT token:

  1. Make a POST request to /auth/login

  2. Include the required X-Org-Id header with your organization ID

  3. Provide your credentials in the request body

  4. The response will include a JWT token to use in subsequent requests

Organizations

Organizations are the top-level container for all resources in Eden. Each user belongs to one or more organizations, and resources (endpoints, templates, workflows) are created within the context of an organization.

Organization Operations
  • POST /new - Create a new organization

  • GET /organizations - Retrieve organization details

  • DELETE /organizations - Delete an organization

  • PATCH /organizations - Update organization details

Identity and Access Management (IAM)

The IAM system allows you to manage users and permissions within your organization.

Role-Based Access Control (RBAC)

Eden implements a comprehensive Role-Based Access Control system that provides sophisticated, fine-grained control over all resources within the platform.

Key features include:

  • Five distinct access levels (SuperAdmin, Admin, Write, Read, None)

  • Controls for multiple resource types (Organizations, Endpoints, Templates, Workflows)

  • Comprehensive API endpoints for permission management

  • Hierarchical permission inheritance with override capabilities

  • Extensive logging and auditing capabilities

Endpoints

Endpoints in Eden represent connections to external systems or services. They allow your application to read from and write to these systems in a standardized way.

Endpoint Operations
  • POST /endpoints - Create a new endpoint connection

  • GET /endpoints/{endpoint} - Retrieve endpoint details

  • DELETE /endpoints/{endpoint} - Disconnect from an endpoint

  • POST /endpoints/{endpoint}/read - Read data from an endpoint

  • POST /endpoints/{endpoint}/write - Write data to an endpoint

Templates

Templates define data transformations that can be reused across your application. They allow you to standardize how data is processed and formatted.

Template Operations
  • POST /templates - Create a template

  • GET /templates/{template} - Retrieve template details

  • POST /templates/{template} - Run a template

  • DELETE /templates/{template} - Delete a template

  • PATCH /templates/{template} - Update a template

  • POST /templates/{template}/render - Render a template with provided data

Workflows

Workflows orchestrate complex processes involving multiple steps, potentially spanning different systems and data transformations.

Workflow Operations
  • POST /workflows - Create a workflow

  • GET /workflows/{workflow} - Retrieve workflow details

  • DELETE /workflows/{workflow} - Delete a workflow

  • PATCH /workflows/{workflow} - Update a workflow

JSON Utilities

Eden provides several utilities for manipulating JSON data:

  • POST /json/flatten - Flatten a nested JSON structure

  • POST /json/map - Apply a mapping function to JSON data

  • POST /json/parse - Parse a JSON string

  • POST /json/reduce - Reduce JSON data using a function

  • POST /json/unflatten - Restore a flattened JSON structure

Eden-MDBS: Multi-Database Management SystemCopied!

MDBS Overview

Eden-MDBS is an ACID-compliant cross-border database abstraction service. A multi-database management system (MDBS) is an infrastructure solution that allows users to interact with multiple independent database systems through a shared API and proxy service.

Depending on the sophistication of an MDBS system, benefits include:

  • Shared credentials

  • Logical database routing

  • Regionalized content caching

  • Abstracted data partitioning

  • Writing or reading from multiple databases in a single transaction

  • Serialized transaction logging

  • And more

Key Features

  • Universal Data Layer: Simplifies and unifies access to diverse data infrastructure

  • Cross-Database Transactions: Enables transactions across multiple database systems with ACID compliance

  • Global Security Credentials: Unified credential management across all connected systems

  • Global Transaction Consistency: Ensures that all transactions are processed in a deterministic sequence

  • Hybrid Deployment Support: Works seamlessly across public cloud, private cloud, and on-premises environments

Use Cases

1. Multi-cloud / Hybrid-cloud Deployments

When an enterprise utilizes a heterogeneous cloud architecture, deploying services across cloud providers or cloud architectures (e.g., public cloud versus on-prem), risks related to service availability, durability, consistency, and security introduce new business challenges. Eden-MDBS abstracts away this complexity, allowing organizations to treat their entire backend infrastructure as a single endpoint, regardless of region, provider, or service.

Case Study Example: Enterprise A is a consumer software business with dozens of independent software products, each with 2-5 separate databases. Managing nearly a hundred different databases across providers and regions created significant inefficiencies. With Eden-MDBS, they connected their distributed databases in under a week, discovered cross-database inefficiencies, and restructured their backend architecture with minimal production impact.

2. Global Security Credentials

When enterprises utilize multiple cloud providers, credential management becomes complex. Over 90% of enterprises use multiple cloud providers (Forbes), requiring sophisticated solutions for cross-system credential management. Eden-MDBS offers access management and security credentials out of the box, ensuring every connected endpoint utilizes the same high-security credentials.

Case Study Example: Enterprise B uses both public cloud and on-premises solutions. Managing two separate credential systems led to delays in updating access when employees joined teams or services were modified, resulting in credential leakage and security risks. By implementing Eden-MDBS as their global credential layer, they achieved a one-user, one-credential approach that drastically reduced risks and simplified credential management.

3. Global Transaction Consistency

For enterprises with multiple independent, globally distributed systems, determining the order of operations across systems is challenging. This is particularly important when transactions at one endpoint can affect outcomes at another. Eden-MDBS ensures every request is processed in a deterministic sequence, reducing inconsistencies and improving performance.

Case Study Example: Enterprise C uses separate product, customer, and accounting databases. When a customer places an order, all three databases need updates, requiring a centralized event architecture that increased latency and reduced performance. With Eden-MDBS as a consistency layer, they ensured operations affecting multiple endpoints processed as deterministic transactions, preventing databases from falling out of sync.

Case StudiesCopied!

Redis Integration

Eden selected Redis for its unique combination of speed, scalability, and deployment flexibility to power their platform infrastructure.

Challenge

Eden needed a low-latency solution to power real-time application infrastructure across both cloud and on-premises environments while reducing onboarding friction for customers. They also needed a system that could support future AI-driven features.

Solution

Redis provided a high-performance caching layer easy to run in customers' on-prem environments while offering cloud scalability when needed. Redis' widespread familiarity reduced implementation overhead and made adoption smoother for both internal developers and customers. For future AI capabilities, Eden plans to use Redis vector database to power features like semantic retrieval.

Key Benefits & Results
  • Scalability & Performance: Effortlessly supports hybrid deployment models without compromising speed

  • Efficiency Gains: Low-latency caching accelerates app responsiveness and streamlines delivery

  • Operational Cost Savings: Reduced infrastructure costs

  • Improved User Experience: Faster onboarding and smoother integrations due to Redis' familiarity and flexibility

Technology in Action
  • Redis Cloud: Used for fast, scalable caching and real-time data access across Eden's infrastructure

  • Redis Vector (planned): Will power upcoming AI features like semantic search

  • Hybrid-ready architecture: Supports both on-prem and cloud scale workflows

"Redis was just a clear win-win — performant, scalable, familiar to our customers, and adaptable for the AI use cases we're building toward." — Devon Tietjen, Co-founder & CTO, Eden

MongoDB Data API Migration

Eden helped a fintech startup navigate the challenge presented by MongoDB's deprecation of their Data API and HTTPS Endpoints.

Challenge

The fintech company had built their core payment processing system around MongoDB's Data API, which allowed their web applications to interact with their database via simple HTTPS requests. When MongoDB announced the deprecation of this service (scheduled for removal on September 30, 2025), they faced a critical business continuity challenge that would require either extensive refactoring of their applications or finding a suitable alternative solution.

Solution

Eden implemented their Multi-Database Management System (Eden-MDBS) as a drop-in replacement for the MongoDB Data API. The solution involved:

  1. API Compatibility Layer: Eden created a compatible REST API that mirrored the existing MongoDB Data API endpoints, allowing the client's applications to continue functioning with minimal code changes

  2. Cross-Database Functionality: The implementation expanded beyond the original MongoDB Data API capabilities, enabling transactions across multiple database systems

  3. Enhanced Security: Implementation of Eden's global security credentials system provided stronger authentication and access controls than the original solution

  4. Future-Proofing: The architecture was designed to be database-agnostic, protecting the client from similar vendor API changes in the future

Key Benefits & Results
  • Business Continuity: Zero downtime during migration with no disruption to end-users

  • Cost Efficiency: 40% reduction in database operation costs through optimized query handling and connection pooling

  • Performance Improvement: 30% faster response times compared to the original MongoDB Data API

  • Simplified Development: Developers could continue using familiar REST patterns while Eden handled the complexity of database interactions

  • Reduced Vendor Lock-in: The solution provided flexibility to integrate with multiple database systems, reducing dependency on a single vendor

Technology in Action
  • Eden-MDBS: Provided the core database abstraction layer

  • Eden API Gateway: Handled authentication, rate limiting, and request routing

  • Eden Workflow Engine: Managed transaction flows across systems

  • Eden Monitoring: Delivered real-time insights into system performance

"When MongoDB announced they were deprecating their Data API, we thought we would have to completely rewrite our applications. Eden's solution not only solved our immediate problem but gave us a more powerful and flexible system than we had before." — CTO of Fintech Client

Implementation Best PracticesCopied!

For effective implementation of the Eden platform:

  1. Start with core use cases: Begin with specific integration challenges that provide immediate value

  2. Plan your organization structure: Design organization hierarchy to match your business needs

  3. Implement proper RBAC: Configure role-based access control early to ensure proper security

  4. Standardize templates: Create reusable data transformation templates to ensure consistency

  5. Build modular workflows: Design workflows as composable units that can be reused

  6. Monitor performance: Use Eden's built-in monitoring to identify bottlenecks early