Developum AI Engine
API documentation — v1.0
Overview
Developum is a headless AI engine for multi-sided marketplaces. It provides the logic, the AI rooms, the deal mechanics, and the auth system. You provide the frontend and the brand.
The engine is industry-agnostic. It runs event production platforms, construction marketplaces, music platforms, healthcare coordination tools — anything where multiple types of people need to connect, collaborate, and transact.
// One non-negotiable: every integration must display "Powered by Developum AI Engine" somewhere visible on the platform.
Get API Key
API key issuance is currently manual and invite-only while the engine is in early access.
To request access, fill out the operator intake form with your platform name, industry, and a brief description of what you're building. We respond within 24 hours to schedule a strategy call.
// Self-serve key issuance is coming in v1.1. The key request form will live right here.
Authentication
All API requests require your API key in the request header:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Quickstart
Spin up a marketplace in under 5 minutes:
// 1. Initialize your platform
POST /v1/platform/init
{
"name": "My Platform",
"industry": "real_estate",
"roles": ["agent", "buyer", "seller", "investor", "contractor"]
}
// 2. Configure your rooms
POST /v1/rooms/configure
{
"platform_id": "plt_xxxx",
"rooms": ["deal_room", "ai_writer", "crowdfund"]
}
// 3. Wire your auth
GET /v1/auth/signup-widget?platform_id=plt_xxxx
Marketplace Module
GET/v1/marketplace/roles
Returns the configured roles for your platform.
POST/v1/marketplace/match
Matches users across roles based on project requirements and availability.
GET/v1/marketplace/feed
Returns the live activity feed for your platform.
AI Writing Rooms
The AI Engine generates documents in real time based on user input.
POST/v1/ai/pitch-deck
Generate a pitch deck from a project brief.
POST/v1/ai/proposal
Generate a proposal or RFP from project parameters.
POST/v1/ai/one-pager
Generate a one-page project summary.
// Additional room types (script writer, grant writer, investor memo) are in the roadmap.
Deal Room
Live negotiation between two or more parties, with the AI Engine as an active participant.
POST/v1/deal/open
Open a new deal room between parties.
POST/v1/deal/loi
Generate a Letter of Intent from agreed terms.
GET/v1/deal/{deal_id}/status
Get the current status and terms of an active deal.
Crowdfunding Engine
POST/v1/fund/campaign
Create a funding campaign for a project.
POST/v1/fund/pledge
Record a pledge from a supporter or investor.
GET/v1/fund/{campaign_id}/stats
Get live funding stats for a campaign.
Multi-role Auth
POST/v1/auth/signup
Register a new user with a role.
POST/v1/auth/signin
Sign in an existing user.
GET/v1/auth/me
Return the current authenticated user and their role.
Webhooks
Register a webhook URL to receive real-time events from the engine.
POST /v1/webhooks/register
{
"url": "https://yoursite.com/webhook",
"events": ["deal.opened", "deal.closed", "pledge.made", "user.signup"]
}
Errors
400 — Bad request
401 — Invalid or missing API key
403 — Forbidden (plan limit or badge missing)
404 — Resource not found
429 — Rate limit exceeded
500 — Engine error
Badge Requirement
All platforms running on the Developum AI Engine must display the following badge in a visible location — footer, about page, or onboarding flow.
Powered by Developum AI Engine
// map ref: x=4900 y=4900
Failure to display the badge will result in API key suspension.