---
title: "Create a project"
method: POST
path: "/api/projects"
tags: ["Project"]
---

# Create a project

`POST /api/projects`

Create a new project within the organisation with optional content copying from an existing project.

## Request body

- object
  - `name` string, required — Name of the project
  - `key` string, required — Unique key identifier for the project (lowercase letters, numbers, and hyphens)
  - `copyContentRef` string, uuid — Project ID to copy content from
  - `protected` boolean — Whether the project should be protected from deletion
  - `version` 'v1' | 'v2' | 'null', nullable — Project version to create (v1 or v2)

## Response `200`

The created project with details

- object — The created project with details
  - `project` object, required — The created project
    - `id` string, uuid, required — Unique identifier of the project
    - `name` string, required — Name of the project
    - `key` string — Unique key identifier for the project
    - `organisationId` string, uuid, required — Organisation ID the project belongs to
    - `version` 'v1' | 'v2', required — Project version (v1 or v2)
    - `createdAt` string, required — Timestamp when the project was created
    - `updatedAt` string, required — Timestamp when the project was last updated
    - `protected` boolean — Whether the project is protected from deletion
    - `deletedAt` string, nullable — Timestamp when the project was soft deleted
    - `decisionsApprovalMode` 'require_one_per_team' | 'none_create_request' | 'require_any' | 'none' | 'null', nullable — Approval mode for decisions
    - `decisionsApprovalGroups` object[] — Groups required for decision approvals
      - `id` string, uuid, required — Unique identifier of the group
      - `name` string, required — Name of the group
      - `description` string — Description of the group
      - `projectId` string, uuid, required — Project ID the group belongs to
      - `roleId` string, uuid — Role ID associated with the group

---

[API](https://skmtc.net/gorules/apis/gorules-agent-api.md) · [All operations](https://skmtc.net/gorules/apis/gorules-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gorules/gorules-agent-api/versions/52c0773fcd80/schema)