# Create a project

**POST /api/v1/orgs/{orgId}/projects**

Create a new project within the organization in the URL path. Agent Engine-native organizations require ORG_ADMIN or SYSTEM_ADMIN and insert an Agent Engine project. Atlas-backed organizations create the project in Atlas using the caller's delegated Atlas grant (ORG_ADMIN on that org; Atlas ORG_OWNER or ORG_GROUP_CREATOR) and return an Agent Engine project record. Agent Engine-owned children under Atlas organizations are not created.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **orgId** (string)
  Organization ID



### Body: application/json (object)
Project to create
- **allow_member_invites** (boolean)

- **description** (string)

- **name** (string)
  Name is trimmed before validation. It must be 1-64 characters and may contain
  Unicode letters/numbers, spaces, and the characters - _ . ( ) , & @ + '.

- **sharing_policy** (object)



## Responses
### 406
Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 201
Created

#### Body: application/json (object)
- **allow_member_invites** (boolean)

- **atlas** (object)

- **can_manage_deployments** (boolean)

- **created_at** (string)

- **description** (string)

- **id** (string)

- **name** (string)

- **org_id** (string)

- **sharing_policy** (object)

- **source** (string)

- **updated_at** (string)

- **workspace_count** (integer)
  WorkspaceCount is the number of non-deleted workspaces in the project.
  Included on list responses and omitted on single-project GET.


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 402
ATLAS_PAYMENT_METHOD_REQUIRED

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
Forbidden

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 404
Not Found

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 409
Conflict

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
Internal Server Error

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 503
Service Unavailable

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)