Wren AI exposes core APIs to manage projects within an organization. You can create, list, retrieve, update, or delete projects. Some operations support optional metadata import, using Model Definition Language (MDL) format.

MDL is a structured, declarative syntax for defining data models, relationships, transformations, and business semantics—bridging the gap between raw database schemas and actionable analytics logic.

It clearly defines entities, columns, relationships, calculated fields, and views. Semantic context from MDL helps the AI generate accurate SQL and consistent analytics logic

🔗
Learn more

What is Modeling Definition Language?

Modeling Overview Guide

Endpoints Overview

GET /projects: List all projects under your organization. Requires an organization-level API key.
POST /projects: Create a new project. Supports optional metadata, SQL pairs, and instructions import. Requires an organization-level API key.
GET /projects/{projectId}: Get details of a specific project. Requires an API key with access to that project (organization or project-scoped).
PUT /projects/{projectId}: Update project details or update metadata. Requires an API key with access to that project (organization or project-scoped).
DELETE /projects/{projectId}: Delete a project. Requires an API key with access to that project (organization or project-scoped).

How to create organization API keys

Visit Organization API Keys to learn more.