---
title: "Create project in the current organization"
method: POST
path: "/v1/projects"
tags: ["Projects"]
---

# Create project in the current organization

`POST /v1/projects`

Creates a new project within the authed organization.
The project key must be unique within the organization.
If this is called in an Organization that has permissions controlled via an external IdP (https://docs.devcycle.com/platform/security-and-guardrails/permissions#full-role-based-access-control-project-level-roles--enterprise-only) - then no users will have permission to access this project.

## Request body

- CreateProjectDto
  - `name` string, required — Project name
  - `key` string, required — A unique key to identify the Project
  - `description` string — A description of the Project
  - `color` string — Project display color, used to highlight different projects on the dashboard. Must use Hex color code.
  - `settings` ProjectSettingsDTO
    - `edgeDB` EdgeDBSettingsDTO, required
      - `enabled` boolean, required
    - `optIn` OptInSettingsDTO, required
      - `title` string, required
      - `description` string, required
      - `enabled` boolean, required
      - `imageURL` string, required
      - `colors` ColorSettingsDTO, required
        - `primary` string, required
        - `secondary` string, required
      - `poweredByAlignment` 'center' | 'left' | 'right' | 'hidden', required
    - `sdkTypeVisibility` SDKTypeVisibilitySettingsDTO, required
      - `enabledInFeatureSettings` boolean, required
    - `lifeCycle` LifeCycleSettingsDTO, required
      - `disableCodeRefChecks` boolean, required
    - `obfuscation` ObfuscationSettingsDTO, required
      - `enabled` boolean, required
      - `required` boolean, required
    - `disablePassthroughRollouts` boolean, required
    - `dynatrace` DynatraceProjectSettingsDTO, required
      - `enabled` boolean
      - `environmentMap` object

## Response `201`

The project has been successfully created

- Project
  - `_id` string, required — A unique Project ID
  - `_organization` string, required — ID of the Organization owning the Project
  - `_createdBy` string, required — ID of the User who created the project
  - `name` string, required — Project name
  - `key` string, required — A unique key to identify the Project
  - `description` string — A description of the Project
  - `color` string — Project display color, used to highlight different projects on the dashboard. Must use Hex color code.
  - `settings` ProjectSettings, required
    - `edgeDB` EdgeDBSettings, required
      - `enabled` boolean, required
    - `optIn` OptInSettings, required
      - `enabled` boolean, required
      - `title` string, required
      - `description` string, required
      - `imageURL` string, required
      - `colors` ColorSettings, required
        - `primary` string, required
        - `secondary` string, required
      - `poweredByAlignment` object, required
    - `sdkTypeVisibility` SDKTypeVisibilitySettings, required
      - `enabledInFeatureSettings` boolean, required
    - `lifeCycle` LifeCycleSettings, required
      - `disableCodeRefChecks` boolean, required
    - `obfuscation` ObfuscationSettings, required
      - `enabled` boolean, required
      - `required` boolean, required
    - `featureApprovalWorkflow` FeatureApprovalWorkflowSettings, required
      - `enabled` boolean, required
      - `allowPublisherBypass` boolean, required
      - `defaultReviewers` string[], required
    - `disablePassthroughRollouts` boolean, required
    - `staleness` StalenessSettings, required
      - `enabled` boolean, required
      - `released` ReleasedStalenessSettings, required
        - `enabled` boolean, required
      - `unmodifiedLong` UnmodifiedLongStalenessSettings, required
        - `enabled` boolean, required
      - `unmodifiedShort` UnmodifiedShortStalenessSettings, required
        - `enabled` boolean, required
      - `unused` UnusedStalenessSettings, required
        - `enabled` boolean, required
      - `email` StalenessEmailSettings, required
        - `enabled` boolean, required
        - `frequency` 'weekly' | 'biweekly' | 'monthly', required
        - `users` string[], required
        - `lastNotification` string, date-time, required
    - `dynatrace` DynatraceProjectSettings, required
      - `enabled` boolean, required
      - `environmentMap` object, required
  - `createdAt` string, date-time, required — The date the Project was created
  - `updatedAt` string, date-time, required — The date the Project was last updated
  - `hasJiraIntegration` boolean, required — Boolean tracking whether this project has a jira integration set up
  - `hasReceivedCodeUsages` boolean, required — Describe if a project has ever received code usages for any variable
  - `hasUserConfigFetch` boolean, required — Boolean indicating whether a user config has been fetched for this project
  - `jiraBaseUrl` string, required — Jira project base url, if the integration is defined
  - `readonly` boolean, required — Controls whether the feature is editable for a given user
  - `vercelEdgeConfigConnections` VercelEdgeConfigConnection[] — Edge Config Connections for the project
    - `edgeConfigName` string, required
    - `configurationId` string, required

## Other responses

- `400` — Invalid request - missing or invalid properties
- `403`
- `409` — Project key already exists

---

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