---
title: "Create a project. It becomes your current project, as on the web."
method: POST
path: "/v1/projects"
---

# Create a project. It becomes your current project, as on the web.

`POST /v1/projects`

## Request

- Base URL: `https://api.lumeta.ai`
- URL: `https://api.lumeta.ai/v1/projects`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `default_aspect_ratio` string

## Response `201`

OK

- Project
  - `id` string
  - `name` string
  - `role` 'owner' | 'editor' | 'viewer'
  - `default_aspect_ratio` string, nullable
  - `generation_count` integer, nullable
  - `current` boolean
  - `created_at` string
  - `last_used_at` string, nullable

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/lumeta/apis/lumeta-api.md) · [All operations](https://skmtc.dev/lumeta/apis/lumeta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumeta/apis/lumeta-api/revisions/9b84c0fe886e?raw)