Projects

Manage projects within an organization.

Project availability: ✅ Classic projects • ✅ Agentic projects

Project management works for both project types, and POST /v2/projects creates either one — pass projectType: "AGENTIC" to create an agentic project, or omit the field to get a classic one.

Two differences to keep in mind:

• MDL can be imported and replaced for both types, but the write path differs. For a classic project the manifest is stored in the database and deployed. For an agentic project the data model is Git-backed, so the manifest is committed to the project's shared-data repository and deployed from there; the response tells you the commitSha. Editing individual mdl/ files is still the Files API's job.
• Knowledge seeding at creation (sqlPairs, instructions) is classic-only. An agentic project keeps its knowledge as files, so send those through the Files API after the project exists.

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 /v2/projects: List all projects under your organization.
  Requires an organization-level API key.
• POST /v2/projects: Create a new project, classic or agentic. Supports optional metadata import, plus SQL pairs and instructions for classic projects.
  Requires an organization-level API key, an active subscription, and room under the plan's project limit.
• GET /v2/projects/{projectId}: Get details of a specific project.
  Requires an API key with access to that project (organization or project-scoped).
• PUT /v2/projects/{projectId}: Update project details, or replace the project's MDL metadata.
  Requires an API key with access to that project (organization or project-scoped).
• DELETE /v2/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.