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

# Create a project

`POST /v1/projects`

## Request

- Base URL: `https://api.semilattice.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.semilattice.ai/v1/projects`
- Auth: none declared

Create a project. Create one first when you plan to run several related
simulations, then pass its id as project_id when creating simulations. Its
simulations plan against context_id, or your default context if none is
given.

## Headers

- `authorization` string

## Request body

- CreateProjectBody
  - `name` string, nullable: Optional project name; defaults to 'New project'
  - `context_id` string, uuid, nullable: Context the project's simulations plan against (from /v1/contexts). Defaults to your most recently updated context, else your organisation's.

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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