Projects

Create a new project

This endpoint creates a new project. Project creation is an asynchronous process.

A successful request is accepted for processing and immediately returns a 202 Accepted response with the new project's unique id.

To prevent duplicate projects from being created due to network issues, this endpoint requires an Idempotency-Key header.

post/demand/accounts/{account_id}/projects

Request

Headers

idempotency-keystring required

A shallow unique ID used as part of the deduplication mechanism for mutable operations. We suggest using UUIDv4 or another random string with sufficient entropy to avoid collisions.

Example:01BTGNYV6HRNK8K8VKZASZCFP0

A shallow unique ID used as part of the deduplication mechanism for mutable operations, this header is required.

Request body

namestring required

The name of the project. Any leading or trailing whitespace will be trimmed.

project_manager_idstring uuid required

Project manager ID.

project_customer_reference_numberstring

A customer-provided reference number assigned to the project.

Example request

{
  "name": "A Project",
  "project_manager_id": "96C65204-90C2-4DCB-9393-B8226DD50C76",
  "project_customer_reference_number": "RF-4567"
}

Response

Confirms that the project creation request has been accepted for processing.

idstring ulid

Example response

{
  "id": "01GV070G3SJECZAGE3Q3J6FV56"
}

Changes

No recorded changes to this operation across all 1 revision of this API.