---
title: "POST /v2/domains/{domainIdentifier}/projects"
method: POST
path: "/v2/domains/{domainIdentifier}/projects"
---

# POST /v2/domains/{domainIdentifier}/projects

`POST /v2/domains/{domainIdentifier}/projects`

Creates an Amazon DataZone project.

## Path parameters

- `domainIdentifier` string, required

## Request body

- object
  - `name` string, password, required — The name of the Amazon DataZone project.
  - `description` string, password — The description of the Amazon DataZone project.
  - `resourceTags` object — The resource tags of the project.
  - `glossaryTerms` GlossaryTermId[] — The glossary terms that can be used in this Amazon DataZone project.
  - `domainUnitId` string — The ID of the domain unit. This parameter is not required and if it is not specified, then the project is created at the root domain unit level.
  - `projectProfileId` string — The ID of the project profile.
  - `userParameters` EnvironmentConfigurationUserParameter[] — The user parameters of the project.
    - `environmentId` string — The ID of the environment.
    - `environmentResolvedAccount` object — Specifies the account/Region that is to be used during project creation for a particular blueprint.
      - `awsAccountId` string, required — The ID of the resolved account.
      - `regionName` string, required — The name of the resolved Region.
      - `sourceAccountPoolId` string — The ID of the account pool.
    - `environmentConfigurationName` string, password — The environment configuration name.
    - `environmentParameters` EnvironmentParameter[] — The environment parameters.
      - `name` string — The name of an environment profile parameter.
      - `value` string — The value of an environment profile parameter.
  - `projectCategory` string — The category of the project. Set to 'ADMIN' designates this as an administrative project for the Amazon DataZone domain.
  - `projectExecutionRole` string — The default project IAM role that is used to access project resources and run computes such as Glue and Sagemaker.
  - `membershipAssignments` ProjectMembershipAssignment[] — The members to be assigned to the project.
    - `member` object, required — The details about a project member.
      - `userIdentifier` string — The user ID of a project member.
      - `groupIdentifier` string — The ID of the group of a project member.
    - `designation` 'PROJECT_OWNER' | 'PROJECT_CONTRIBUTOR' | 'PROJECT_CATALOG_VIEWER' | 'PROJECT_CATALOG_CONSUMER' | 'PROJECT_CATALOG_STEWARD', required — The designation of the project membership.

## Response `201`

Success

- CreateProjectOutput
  - `domainId` string, required — The identifier of the Amazon DataZone domain in which the project was created.
  - `id` string, required — The ID of the Amazon DataZone project.
  - `name` string, password, required — The name of the project.
  - `description` string, password — The description of the project.
  - `projectStatus` 'ACTIVE' | 'DELETING' | 'DELETE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'MOVING' — The status of the Amazon DataZone project that was created.
  - `failureReasons` ProjectDeletionError[] — Specifies the error message that is returned if the operation cannot be successfully completed.
    - `code` string — The code of the project deletion error.
    - `message` string — The message of the project deletion error.
  - `createdBy` string, required — The Amazon DataZone user who created the project.
  - `createdAt` string, date-time — The timestamp of when the project was created.
  - `lastUpdatedAt` string, date-time — The timestamp of when the project was last updated.
  - `resourceTags` ResourceTag[] — The resource tags of the project.
    - `key` string, required — The key of the resource tag of the project.
    - `value` string, required — The value of the resource tag of the project.
    - `source` 'PROJECT' | 'PROJECT_PROFILE', required — The source of the resource tag of the project.
  - `glossaryTerms` GlossaryTermId[] — The glossary terms that can be used in the project.
  - `domainUnitId` string — The ID of the domain unit.
  - `projectProfileId` string — The project profile ID.
  - `userParameters` EnvironmentConfigurationUserParameter[] — The user parameters of the project.
    - `environmentId` string — The ID of the environment.
    - `environmentResolvedAccount` object — Specifies the account/Region that is to be used during project creation for a particular blueprint.
      - `awsAccountId` string, required — The ID of the resolved account.
      - `regionName` string, required — The name of the resolved Region.
      - `sourceAccountPoolId` string — The ID of the account pool.
    - `environmentConfigurationName` string, password — The environment configuration name.
    - `environmentParameters` EnvironmentParameter[] — The environment parameters.
      - `name` string — The name of an environment profile parameter.
      - `value` string — The value of an environment profile parameter.
  - `environmentDeploymentDetails` object — The environment deployment details.
    - `overallDeploymentStatus` 'PENDING_DEPLOYMENT' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED_VALIDATION' | 'FAILED_DEPLOYMENT' — The overall deployment status of the environment.
    - `environmentFailureReasons` object — Environment failure reasons.
  - `projectCategory` string — The category of the project.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/versions/055599054b53/schema)