---
title: "Create a new project with a blank canvas"
method: POST
path: "/v1/projects/with-canvas"
tags: ["Projects"]
---

# Create a new project with a blank canvas

`POST /v1/projects/with-canvas`

## Request body

- CreateCanvasProjectDto
  - `name` string, required — Project name
  - `type` 'renovation' | 'new_home_construction' | 'other' — Type of project
  - `estimatedBudget` number — Estimated budget for the project
  - `currency` string — Currency for the budget
  - `externalLocationId` string — External location ID from geocoding service (AWS PlaceId, Google PlaceId, etc.)
  - `unitSystem` 'imperial' | 'metric' — Preferred measurement unit system

## Response `201`

Project and canvas created successfully

- CreateCanvasProjectApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `projectId` string, uuid, required
    - `assetId` string, uuid, required
  - `timestamp` string, date-time, required — Timestamp of the response

## Changes

- **2026-09-25** `ad71cae36f29` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maket/apis/virtual-architect-api/changes/v1/projects/with-canvas/post.md)

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maket/apis/virtual-architect-api/revisions/ad71cae36f29?raw)