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

# Create a new project

`POST /v2/projects`

Creates a project in the current workspace. Projects are workspace-level containers for resources such as skills, deployments, datasets, rules, and related team access.

## Request body

- CreateProjectRequest
  - `name` string, required — Project name. Names must be non-empty and at most 128 characters.
  - `teams` string[] — Team identifiers to associate with the project.
  - `description` string — Optional human-readable description, at most 500 characters.

## Response `200`

OK

- CreateProjectResponse
  - `project` Project, required
    - `project_id` string, required — Unique project identifier assigned by ORQ. Use this value in retrieve, update, and delete requests.
    - `name` string, required — Human-readable project name.
    - `key` string, required — Stable project key generated from the name and used by internal workspace navigation.
    - `is_archived` boolean, required — Whether the project is archived and hidden from normal active project lists.
    - `is_default` boolean, required — Whether this is the workspace default project.
    - `teams` string[], required — Team identifiers associated with the project for access and organization.
    - `created_at` string, date-time, required — Time when the project was created.
    - `updated_at` string, date-time, required — Time when the project was last updated.
    - `created_by_id` string — User ID that created the project.
    - `updated_by_id` string — User ID that last updated the project.
    - `description` string — Optional human-readable description of the project.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/1072e5ba28ab/schema)